@terreno/admin-frontend 57.21.0 → 58.0.0-beta.2

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 (550) hide show
  1. package/.ai/guidelines/core.md +6 -5
  2. package/CHANGELOG.md +89 -0
  3. package/README.md +33 -21
  4. package/dist/AdminFieldRenderer.d.ts.map +1 -1
  5. package/dist/AdminFieldRenderer.js +4 -4
  6. package/dist/AdminFieldRenderer.js.map +1 -1
  7. package/dist/AdminFieldRendererCore.d.ts.map +1 -1
  8. package/dist/AdminFieldRendererCore.js +9 -9
  9. package/dist/AdminFieldRendererCore.js.map +1 -1
  10. package/dist/AdminFilterDrawer.d.ts +1 -2
  11. package/dist/AdminFilterDrawer.d.ts.map +1 -1
  12. package/dist/AdminFilterDrawer.js +4 -4
  13. package/dist/AdminFilterDrawer.js.map +1 -1
  14. package/dist/AdminHome.d.ts +0 -2
  15. package/dist/AdminHome.d.ts.map +1 -1
  16. package/dist/AdminHome.js +4 -5
  17. package/dist/AdminHome.js.map +1 -1
  18. package/dist/AdminMigrations.d.ts.map +1 -1
  19. package/dist/AdminMigrations.js +3 -3
  20. package/dist/AdminMigrations.js.map +1 -1
  21. package/dist/AdminMigrationsView.d.ts +1 -2
  22. package/dist/AdminMigrationsView.d.ts.map +1 -1
  23. package/dist/AdminMigrationsView.js +3 -3
  24. package/dist/AdminMigrationsView.js.map +1 -1
  25. package/dist/AdminModelForm.d.ts +3 -6
  26. package/dist/AdminModelForm.d.ts.map +1 -1
  27. package/dist/AdminModelForm.js +8 -11
  28. package/dist/AdminModelForm.js.map +1 -1
  29. package/dist/AdminModelList.d.ts +2 -5
  30. package/dist/AdminModelList.d.ts.map +1 -1
  31. package/dist/AdminModelList.js +4 -6
  32. package/dist/AdminModelList.js.map +1 -1
  33. package/dist/AdminModelTable.d.ts +0 -2
  34. package/dist/AdminModelTable.d.ts.map +1 -1
  35. package/dist/AdminModelTable.js +12 -28
  36. package/dist/AdminModelTable.js.map +1 -1
  37. package/dist/AdminNestedArrayField.d.ts +1 -2
  38. package/dist/AdminNestedArrayField.d.ts.map +1 -1
  39. package/dist/AdminNestedArrayField.js +4 -7
  40. package/dist/AdminNestedArrayField.js.map +1 -1
  41. package/dist/AdminObjectPicker.d.ts +0 -2
  42. package/dist/AdminObjectPicker.d.ts.map +1 -1
  43. package/dist/AdminObjectPicker.js +18 -63
  44. package/dist/AdminObjectPicker.js.map +1 -1
  45. package/dist/AdminPrimitiveArrayField.d.ts +1 -2
  46. package/dist/AdminPrimitiveArrayField.d.ts.map +1 -1
  47. package/dist/AdminPrimitiveArrayField.js +3 -3
  48. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  49. package/dist/AdminProvider.d.ts.map +1 -1
  50. package/dist/AdminProvider.js +3 -9
  51. package/dist/AdminProvider.js.map +1 -1
  52. package/dist/AdminRefField.d.ts.map +1 -1
  53. package/dist/AdminRefField.js +2 -2
  54. package/dist/AdminRefField.js.map +1 -1
  55. package/dist/AdminRolesField.d.ts.map +1 -1
  56. package/dist/AdminRolesField.js +2 -2
  57. package/dist/AdminRolesField.js.map +1 -1
  58. package/dist/AdminRolesList.js +2 -2
  59. package/dist/AdminRolesList.js.map +1 -1
  60. package/dist/AdminScreenRouter.d.ts.map +1 -1
  61. package/dist/AdminScreenRouter.js +6 -6
  62. package/dist/AdminScreenRouter.js.map +1 -1
  63. package/dist/AdminScriptList.d.ts +0 -2
  64. package/dist/AdminScriptList.d.ts.map +1 -1
  65. package/dist/AdminScriptList.js +5 -5
  66. package/dist/AdminScriptList.js.map +1 -1
  67. package/dist/AdminScriptRunModal.d.ts +0 -2
  68. package/dist/AdminScriptRunModal.d.ts.map +1 -1
  69. package/dist/AdminScriptRunModal.js +2 -2
  70. package/dist/AdminScriptRunModal.js.map +1 -1
  71. package/dist/AdminShell.d.ts +1 -2
  72. package/dist/AdminShell.d.ts.map +1 -1
  73. package/dist/AdminShell.js +2 -2
  74. package/dist/AdminShell.js.map +1 -1
  75. package/dist/AdminShellLayout.d.ts +1 -1
  76. package/dist/AdminShellLayout.js +1 -1
  77. package/dist/AdminVersionConfig.d.ts +0 -2
  78. package/dist/AdminVersionConfig.d.ts.map +1 -1
  79. package/dist/AdminVersionConfig.js +8 -40
  80. package/dist/AdminVersionConfig.js.map +1 -1
  81. package/dist/AnnouncementEditor.d.ts +0 -2
  82. package/dist/AnnouncementEditor.d.ts.map +1 -1
  83. package/dist/AnnouncementEditor.js +20 -42
  84. package/dist/AnnouncementEditor.js.map +1 -1
  85. package/dist/AnnouncementList.d.ts +0 -2
  86. package/dist/AnnouncementList.d.ts.map +1 -1
  87. package/dist/AnnouncementList.js +3 -3
  88. package/dist/AnnouncementList.js.map +1 -1
  89. package/dist/AnnouncementOverview.d.ts +0 -2
  90. package/dist/AnnouncementOverview.d.ts.map +1 -1
  91. package/dist/AnnouncementOverview.js +11 -30
  92. package/dist/AnnouncementOverview.js.map +1 -1
  93. package/dist/AnnouncementOverviewScreenWidget.d.ts.map +1 -1
  94. package/dist/AnnouncementOverviewScreenWidget.js +2 -2
  95. package/dist/AnnouncementOverviewScreenWidget.js.map +1 -1
  96. package/dist/ConfigurationScreen.d.ts +1 -5
  97. package/dist/ConfigurationScreen.d.ts.map +1 -1
  98. package/dist/ConfigurationScreen.js +3 -4
  99. package/dist/ConfigurationScreen.js.map +1 -1
  100. package/dist/ConsentFormEditor.d.ts +0 -2
  101. package/dist/ConsentFormEditor.d.ts.map +1 -1
  102. package/dist/ConsentFormEditor.js +13 -65
  103. package/dist/ConsentFormEditor.js.map +1 -1
  104. package/dist/ConsentFormList.d.ts +0 -2
  105. package/dist/ConsentFormList.d.ts.map +1 -1
  106. package/dist/ConsentFormList.js +3 -3
  107. package/dist/ConsentFormList.js.map +1 -1
  108. package/dist/ConsentHistory.d.ts +0 -2
  109. package/dist/ConsentHistory.d.ts.map +1 -1
  110. package/dist/ConsentHistory.js +2 -2
  111. package/dist/ConsentHistory.js.map +1 -1
  112. package/dist/ConsentResponseViewer.d.ts +0 -2
  113. package/dist/ConsentResponseViewer.d.ts.map +1 -1
  114. package/dist/ConsentResponseViewer.js +3 -3
  115. package/dist/ConsentResponseViewer.js.map +1 -1
  116. package/dist/DocumentStorageBrowser.d.ts.map +1 -1
  117. package/dist/DocumentStorageBrowser.js +2 -2
  118. package/dist/DocumentStorageBrowser.js.map +1 -1
  119. package/dist/adminApiQueryParams.d.ts +1 -1
  120. package/dist/adminApiQueryParams.d.ts.map +1 -1
  121. package/dist/adminApiQueryParams.js +1 -1
  122. package/dist/adminApiQueryParams.js.map +1 -1
  123. package/dist/adminRequest.d.ts +5 -4
  124. package/dist/adminRequest.d.ts.map +1 -1
  125. package/dist/adminRequest.js +19 -102
  126. package/dist/adminRequest.js.map +1 -1
  127. package/dist/adminWindowedTable.d.ts +1 -2
  128. package/dist/adminWindowedTable.d.ts.map +1 -1
  129. package/dist/adminWindowedTable.js +2 -2
  130. package/dist/adminWindowedTable.js.map +1 -1
  131. package/dist/comms/CommsDashboardScreen.d.ts +0 -2
  132. package/dist/comms/CommsDashboardScreen.d.ts.map +1 -1
  133. package/dist/comms/CommsDashboardScreen.js +2 -2
  134. package/dist/comms/CommsDashboardScreen.js.map +1 -1
  135. package/dist/comms/CommsDashboardScreenWidget.d.ts.map +1 -1
  136. package/dist/comms/CommsDashboardScreenWidget.js +2 -2
  137. package/dist/comms/CommsDashboardScreenWidget.js.map +1 -1
  138. package/dist/comms/CommsMessageDetail.d.ts +0 -2
  139. package/dist/comms/CommsMessageDetail.d.ts.map +1 -1
  140. package/dist/comms/CommsMessageDetail.js +5 -5
  141. package/dist/comms/CommsMessageDetail.js.map +1 -1
  142. package/dist/comms/useCommsDashboardApi.d.ts +6 -19
  143. package/dist/comms/useCommsDashboardApi.d.ts.map +1 -1
  144. package/dist/comms/useCommsDashboardApi.js +34 -93
  145. package/dist/comms/useCommsDashboardApi.js.map +1 -1
  146. package/dist/consentPdfTemplates.d.ts +1 -0
  147. package/dist/consentPdfTemplates.d.ts.map +1 -1
  148. package/dist/consentPdfTemplates.js.map +1 -1
  149. package/dist/index.d.ts +3 -3
  150. package/dist/index.d.ts.map +1 -1
  151. package/dist/index.js +2 -2
  152. package/dist/index.js.map +1 -1
  153. package/dist/jobs/JobsDashboardScreen.d.ts +0 -2
  154. package/dist/jobs/JobsDashboardScreen.d.ts.map +1 -1
  155. package/dist/jobs/JobsDashboardScreen.js +2 -2
  156. package/dist/jobs/JobsDashboardScreen.js.map +1 -1
  157. package/dist/jobs/JobsDashboardScreenWidget.d.ts.map +1 -1
  158. package/dist/jobs/JobsDashboardScreenWidget.js +2 -2
  159. package/dist/jobs/JobsDashboardScreenWidget.js.map +1 -1
  160. package/dist/jobs/JobsHomeWidget.js +2 -2
  161. package/dist/jobs/JobsHomeWidget.js.map +1 -1
  162. package/dist/jobs/JobsJobDetail.d.ts +0 -2
  163. package/dist/jobs/JobsJobDetail.d.ts.map +1 -1
  164. package/dist/jobs/JobsJobDetail.js +2 -2
  165. package/dist/jobs/JobsJobDetail.js.map +1 -1
  166. package/dist/jobs/jobPayload.d.ts +1 -1
  167. package/dist/jobs/jobPayload.d.ts.map +1 -1
  168. package/dist/jobs/useJobsDashboardApi.d.ts +29 -53
  169. package/dist/jobs/useJobsDashboardApi.d.ts.map +1 -1
  170. package/dist/jobs/useJobsDashboardApi.js +50 -84
  171. package/dist/jobs/useJobsDashboardApi.js.map +1 -1
  172. package/dist/orgs/MemberSecurityPanel.js.map +1 -1
  173. package/dist/orgs/OrgDirectoryScreen.d.ts +0 -2
  174. package/dist/orgs/OrgDirectoryScreen.d.ts.map +1 -1
  175. package/dist/orgs/OrgDirectoryScreen.js +5 -3
  176. package/dist/orgs/OrgDirectoryScreen.js.map +1 -1
  177. package/dist/orgs/OrgMembersScreen.d.ts +0 -2
  178. package/dist/orgs/OrgMembersScreen.d.ts.map +1 -1
  179. package/dist/orgs/OrgMembersScreen.js +3 -3
  180. package/dist/orgs/OrgMembersScreen.js.map +1 -1
  181. package/dist/orgs/OrgSettingsScreen.d.ts +0 -2
  182. package/dist/orgs/OrgSettingsScreen.d.ts.map +1 -1
  183. package/dist/orgs/OrgSettingsScreen.js +2 -2
  184. package/dist/orgs/OrgSettingsScreen.js.map +1 -1
  185. package/dist/orgs/OrgSwitcher.d.ts +0 -2
  186. package/dist/orgs/OrgSwitcher.d.ts.map +1 -1
  187. package/dist/orgs/OrgSwitcher.js +2 -2
  188. package/dist/orgs/OrgSwitcher.js.map +1 -1
  189. package/dist/orgs/normalizeListData.d.ts +2 -3
  190. package/dist/orgs/normalizeListData.d.ts.map +1 -1
  191. package/dist/orgs/normalizeListData.js.map +1 -1
  192. package/dist/orgs/organizationHeaders.d.ts +3 -0
  193. package/dist/orgs/organizationHeaders.d.ts.map +1 -0
  194. package/dist/orgs/organizationHeaders.js +8 -0
  195. package/dist/orgs/organizationHeaders.js.map +1 -0
  196. package/dist/orgs/useMemberSecurityApi.js +1 -1
  197. package/dist/orgs/useMemberSecurityApi.js.map +1 -1
  198. package/dist/orgs/useOrganizationsApi.d.ts +38 -13
  199. package/dist/orgs/useOrganizationsApi.d.ts.map +1 -1
  200. package/dist/orgs/useOrganizationsApi.js +89 -87
  201. package/dist/orgs/useOrganizationsApi.js.map +1 -1
  202. package/dist/types.d.ts +3 -29
  203. package/dist/types.d.ts.map +1 -1
  204. package/dist/types.js.map +1 -1
  205. package/dist/useAdminBackgroundTask.d.ts +2 -3
  206. package/dist/useAdminBackgroundTask.d.ts.map +1 -1
  207. package/dist/useAdminBackgroundTask.js +11 -33
  208. package/dist/useAdminBackgroundTask.js.map +1 -1
  209. package/dist/useAdminConfig.d.ts +9 -11
  210. package/dist/useAdminConfig.d.ts.map +1 -1
  211. package/dist/useAdminConfig.js +10 -38
  212. package/dist/useAdminConfig.js.map +1 -1
  213. package/dist/useAdminMigrations.d.ts +18 -19
  214. package/dist/useAdminMigrations.d.ts.map +1 -1
  215. package/dist/useAdminMigrations.js +19 -39
  216. package/dist/useAdminMigrations.js.map +1 -1
  217. package/dist/useAdminModelApi.d.ts +72 -0
  218. package/dist/useAdminModelApi.d.ts.map +1 -0
  219. package/dist/useAdminModelApi.js +94 -0
  220. package/dist/useAdminModelApi.js.map +1 -0
  221. package/dist/useAdminRoles.d.ts +10 -11
  222. package/dist/useAdminRoles.d.ts.map +1 -1
  223. package/dist/useAdminRoles.js +29 -97
  224. package/dist/useAdminRoles.js.map +1 -1
  225. package/dist/useAdminRpc.d.ts +46 -12
  226. package/dist/useAdminRpc.d.ts.map +1 -1
  227. package/dist/useAdminRpc.js +91 -30
  228. package/dist/useAdminRpc.js.map +1 -1
  229. package/dist/useAdminScripts.d.ts +37 -41
  230. package/dist/useAdminScripts.d.ts.map +1 -1
  231. package/dist/useAdminScripts.js +42 -109
  232. package/dist/useAdminScripts.js.map +1 -1
  233. package/dist/useConfigurationApi.d.ts +8 -16
  234. package/dist/useConfigurationApi.d.ts.map +1 -1
  235. package/dist/useConfigurationApi.js +16 -66
  236. package/dist/useConfigurationApi.js.map +1 -1
  237. package/dist/useConsentHistory.d.ts +3 -34
  238. package/dist/useConsentHistory.d.ts.map +1 -1
  239. package/dist/useConsentHistory.js +10 -38
  240. package/dist/useConsentHistory.js.map +1 -1
  241. package/dist/useDocumentStorageApi.d.ts +36 -8
  242. package/dist/useDocumentStorageApi.d.ts.map +1 -1
  243. package/dist/useDocumentStorageApi.js +65 -151
  244. package/dist/useDocumentStorageApi.js.map +1 -1
  245. package/dist/widgets/AIRequestsScreenWidget.d.ts.map +1 -1
  246. package/dist/widgets/AIRequestsScreenWidget.js +3 -21
  247. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -1
  248. package/dist/widgets/DocumentsScreenWidget.d.ts.map +1 -1
  249. package/dist/widgets/DocumentsScreenWidget.js +2 -2
  250. package/dist/widgets/DocumentsScreenWidget.js.map +1 -1
  251. package/dist/widgets/ModelsGridWidget.d.ts.map +1 -1
  252. package/dist/widgets/ModelsGridWidget.js +5 -5
  253. package/dist/widgets/ModelsGridWidget.js.map +1 -1
  254. package/dist/widgets/RecentActivityWidget.js +3 -3
  255. package/dist/widgets/RecentActivityWidget.js.map +1 -1
  256. package/dist/widgets/VersionConfigScreenWidget.d.ts.map +1 -1
  257. package/dist/widgets/VersionConfigScreenWidget.js +2 -2
  258. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -1
  259. package/dist/widgets/VersionConfigWidget.js +2 -2
  260. package/dist/widgets/VersionConfigWidget.js.map +1 -1
  261. package/dist/widgets/aiObservability/datasets/AiDatasetDetailScreen.js +4 -4
  262. package/dist/widgets/aiObservability/datasets/AiDatasetDetailScreen.js.map +1 -1
  263. package/dist/widgets/aiObservability/datasets/AiDatasetsListScreen.js +4 -4
  264. package/dist/widgets/aiObservability/datasets/AiDatasetsListScreen.js.map +1 -1
  265. package/dist/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.d.ts +30 -71
  266. package/dist/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.d.ts.map +1 -1
  267. package/dist/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.js +48 -95
  268. package/dist/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.js.map +1 -1
  269. package/dist/widgets/aiObservability/evaluators/AiEvaluatorDetailScreen.js +4 -4
  270. package/dist/widgets/aiObservability/evaluators/AiEvaluatorDetailScreen.js.map +1 -1
  271. package/dist/widgets/aiObservability/evaluators/AiEvaluatorNewScreen.js +3 -3
  272. package/dist/widgets/aiObservability/evaluators/AiEvaluatorNewScreen.js.map +1 -1
  273. package/dist/widgets/aiObservability/evaluators/AiEvaluatorsListScreen.js +3 -3
  274. package/dist/widgets/aiObservability/evaluators/AiEvaluatorsListScreen.js.map +1 -1
  275. package/dist/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.d.ts +12 -31
  276. package/dist/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.d.ts.map +1 -1
  277. package/dist/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.js +19 -46
  278. package/dist/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.js.map +1 -1
  279. package/dist/widgets/aiObservability/experiments/AiExperimentNewScreen.js +5 -5
  280. package/dist/widgets/aiObservability/experiments/AiExperimentNewScreen.js.map +1 -1
  281. package/dist/widgets/aiObservability/experiments/AiExperimentResultsScreen.js +4 -4
  282. package/dist/widgets/aiObservability/experiments/AiExperimentResultsScreen.js.map +1 -1
  283. package/dist/widgets/aiObservability/experiments/AiExperimentsListScreen.js +3 -3
  284. package/dist/widgets/aiObservability/experiments/AiExperimentsListScreen.js.map +1 -1
  285. package/dist/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.d.ts +18 -49
  286. package/dist/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.d.ts.map +1 -1
  287. package/dist/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.js +33 -65
  288. package/dist/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.js.map +1 -1
  289. package/dist/widgets/aiObservability/prompts/AiPromptEditorScreen.d.ts.map +1 -1
  290. package/dist/widgets/aiObservability/prompts/AiPromptEditorScreen.js +6 -4
  291. package/dist/widgets/aiObservability/prompts/AiPromptEditorScreen.js.map +1 -1
  292. package/dist/widgets/aiObservability/prompts/AiPromptEditorView.d.ts.map +1 -1
  293. package/dist/widgets/aiObservability/prompts/AiPromptEditorView.js +19 -9
  294. package/dist/widgets/aiObservability/prompts/AiPromptEditorView.js.map +1 -1
  295. package/dist/widgets/aiObservability/prompts/AiPromptPlaygroundView.d.ts.map +1 -1
  296. package/dist/widgets/aiObservability/prompts/AiPromptPlaygroundView.js +6 -1
  297. package/dist/widgets/aiObservability/prompts/AiPromptPlaygroundView.js.map +1 -1
  298. package/dist/widgets/aiObservability/prompts/AiPromptsListScreen.js +2 -2
  299. package/dist/widgets/aiObservability/prompts/AiPromptsListScreen.js.map +1 -1
  300. package/dist/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.d.ts +18 -61
  301. package/dist/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.d.ts.map +1 -1
  302. package/dist/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.js +47 -82
  303. package/dist/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.js.map +1 -1
  304. package/dist/widgets/aiObservability/review/AiReviewItemScreen.d.ts.map +1 -1
  305. package/dist/widgets/aiObservability/review/AiReviewItemScreen.js +5 -3
  306. package/dist/widgets/aiObservability/review/AiReviewItemScreen.js.map +1 -1
  307. package/dist/widgets/aiObservability/review/AiReviewQueueScreen.js +2 -2
  308. package/dist/widgets/aiObservability/review/AiReviewQueueScreen.js.map +1 -1
  309. package/dist/widgets/aiObservability/review/useAiObservabilityReviewApi.d.ts +12 -35
  310. package/dist/widgets/aiObservability/review/useAiObservabilityReviewApi.d.ts.map +1 -1
  311. package/dist/widgets/aiObservability/review/useAiObservabilityReviewApi.js +25 -63
  312. package/dist/widgets/aiObservability/review/useAiObservabilityReviewApi.js.map +1 -1
  313. package/dist/widgets/aiObservability/shell/AiObservabilityChrome.d.ts.map +1 -1
  314. package/dist/widgets/aiObservability/shell/AiObservabilityChrome.js +2 -2
  315. package/dist/widgets/aiObservability/shell/AiObservabilityChrome.js.map +1 -1
  316. package/dist/widgets/aiObservability/shell/AiObservabilityStatusChip.d.ts +0 -2
  317. package/dist/widgets/aiObservability/shell/AiObservabilityStatusChip.d.ts.map +1 -1
  318. package/dist/widgets/aiObservability/shell/AiObservabilityStatusChip.js +7 -24
  319. package/dist/widgets/aiObservability/shell/AiObservabilityStatusChip.js.map +1 -1
  320. package/dist/widgets/aiObservability/shell/observabilityRequest.d.ts +40 -0
  321. package/dist/widgets/aiObservability/shell/observabilityRequest.d.ts.map +1 -0
  322. package/dist/widgets/aiObservability/shell/observabilityRequest.js +62 -0
  323. package/dist/widgets/aiObservability/shell/observabilityRequest.js.map +1 -0
  324. package/dist/widgets/aiObservability/traces/AiTraceDetailScreen.d.ts.map +1 -1
  325. package/dist/widgets/aiObservability/traces/AiTraceDetailScreen.js +5 -3
  326. package/dist/widgets/aiObservability/traces/AiTraceDetailScreen.js.map +1 -1
  327. package/dist/widgets/aiObservability/traces/AiTracesListScreen.js +4 -4
  328. package/dist/widgets/aiObservability/traces/AiTracesListScreen.js.map +1 -1
  329. package/dist/widgets/aiObservability/traces/useAiObservabilityTracesApi.d.ts +18 -46
  330. package/dist/widgets/aiObservability/traces/useAiObservabilityTracesApi.d.ts.map +1 -1
  331. package/dist/widgets/aiObservability/traces/useAiObservabilityTracesApi.js +32 -72
  332. package/dist/widgets/aiObservability/traces/useAiObservabilityTracesApi.js.map +1 -1
  333. package/dist/widgets/harness/HarnessApprovalInbox.d.ts.map +1 -1
  334. package/dist/widgets/harness/HarnessApprovalInbox.js +5 -5
  335. package/dist/widgets/harness/HarnessApprovalInbox.js.map +1 -1
  336. package/dist/widgets/harness/useHarnessApprovals.d.ts +0 -1
  337. package/dist/widgets/harness/useHarnessApprovals.d.ts.map +1 -1
  338. package/dist/widgets/harness/useHarnessApprovals.js +0 -2
  339. package/dist/widgets/harness/useHarnessApprovals.js.map +1 -1
  340. package/package.json +12 -15
  341. package/src/AdminFieldRenderer.test.tsx +3 -4
  342. package/src/AdminFieldRenderer.tsx +0 -4
  343. package/src/AdminFieldRendererCore.tsx +0 -9
  344. package/src/AdminFilterDrawer.tsx +2 -8
  345. package/src/AdminHome.test.tsx +36 -31
  346. package/src/AdminHome.tsx +3 -8
  347. package/src/AdminMigrations.tsx +2 -7
  348. package/src/AdminMigrationsView.tsx +3 -5
  349. package/src/AdminModelForm.isolated.tsx +38 -202
  350. package/src/AdminModelForm.orgSkip.test.tsx +9 -12
  351. package/src/AdminModelForm.tsx +5 -14
  352. package/src/AdminModelForm.updateDepth.test.tsx +10 -28
  353. package/src/AdminModelList.test.tsx +10 -19
  354. package/src/AdminModelList.tsx +3 -12
  355. package/src/AdminModelTable.test.tsx +60 -118
  356. package/src/AdminModelTable.tsx +10 -36
  357. package/src/AdminModelTable.windowed.test.tsx +31 -49
  358. package/src/AdminNestedArrayField.tsx +1 -10
  359. package/src/AdminNestedObjectField.test.tsx +1 -13
  360. package/src/AdminObjectPicker.tsx +21 -72
  361. package/src/AdminPrimitiveArrayField.test.tsx +4 -32
  362. package/src/AdminPrimitiveArrayField.tsx +1 -5
  363. package/src/AdminProvider.test.tsx +3 -8
  364. package/src/AdminProvider.tsx +5 -9
  365. package/src/AdminRefField.tsx +0 -2
  366. package/src/AdminRolesField.tsx +1 -2
  367. package/src/AdminRolesList.test.tsx +33 -50
  368. package/src/AdminRolesList.tsx +2 -2
  369. package/src/AdminScreenRouter.test.tsx +100 -95
  370. package/src/AdminScreenRouter.tsx +4 -11
  371. package/src/AdminScriptList.test.tsx +14 -22
  372. package/src/AdminScriptList.tsx +4 -7
  373. package/src/AdminScriptRunModal.tsx +2 -4
  374. package/src/AdminShell.test.tsx +22 -39
  375. package/src/AdminShell.tsx +2 -4
  376. package/src/AdminShellLayout.tsx +1 -1
  377. package/src/AdminVersionConfig.test.tsx +69 -83
  378. package/src/AdminVersionConfig.tsx +15 -53
  379. package/src/AnnouncementEditor.test.tsx +141 -163
  380. package/src/AnnouncementEditor.tsx +37 -50
  381. package/src/AnnouncementList.test.tsx +16 -35
  382. package/src/AnnouncementList.tsx +3 -5
  383. package/src/AnnouncementOverview.test.tsx +74 -83
  384. package/src/AnnouncementOverview.tsx +10 -33
  385. package/src/AnnouncementOverviewScreenWidget.test.tsx +4 -10
  386. package/src/AnnouncementOverviewScreenWidget.tsx +1 -5
  387. package/src/ConfigurationScreen.test.tsx +7 -10
  388. package/src/ConfigurationScreen.tsx +2 -7
  389. package/src/ConsentFormEditor.test.tsx +92 -173
  390. package/src/ConsentFormEditor.tsx +32 -79
  391. package/src/ConsentFormList.test.tsx +13 -28
  392. package/src/ConsentFormList.tsx +3 -5
  393. package/src/ConsentHistory.test.tsx +86 -78
  394. package/src/ConsentHistory.tsx +2 -7
  395. package/src/ConsentResponseViewer.test.tsx +21 -35
  396. package/src/ConsentResponseViewer.tsx +5 -7
  397. package/src/DocumentStorageBrowser.test.tsx +23 -76
  398. package/src/DocumentStorageBrowser.tsx +1 -2
  399. package/src/adminApiQueryParams.ts +1 -1
  400. package/src/adminPageAccess.test.ts +1 -1
  401. package/src/adminRequest.ts +20 -108
  402. package/src/adminWindowedTable.test.ts +1 -13
  403. package/src/adminWindowedTable.ts +2 -7
  404. package/src/comms/CommsDashboardScreen.test.tsx +150 -114
  405. package/src/comms/CommsDashboardScreen.tsx +1 -4
  406. package/src/comms/CommsDashboardScreenWidget.test.tsx +33 -35
  407. package/src/comms/CommsDashboardScreenWidget.tsx +1 -2
  408. package/src/comms/CommsMessageDetail.test.tsx +116 -76
  409. package/src/comms/CommsMessageDetail.tsx +1 -8
  410. package/src/comms/useCommsDashboardApi.test.tsx +95 -89
  411. package/src/comms/useCommsDashboardApi.tsx +43 -130
  412. package/src/consentPdfTemplates.ts +1 -0
  413. package/src/index.tsx +13 -3
  414. package/src/isolated/AdminFieldRenderer.isolated.tsx +5 -11
  415. package/src/isolated/AdminFilterDrawer.isolated.tsx +0 -7
  416. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +0 -2
  417. package/src/isolated/AdminHomeWidgets.isolated.tsx +3 -4
  418. package/src/isolated/AdminNestedArrayField.isolated.tsx +1 -18
  419. package/src/isolated/AdminObjectPicker.isolated.tsx +76 -76
  420. package/src/isolated/AdminRefField.isolated.tsx +1 -3
  421. package/src/isolated/AdminScriptList.isolated.tsx +4 -4
  422. package/src/isolated/AdminScriptRunModal.isolated.tsx +3 -54
  423. package/src/isolated/AiPromptEditorScreen.isolated.tsx +157 -122
  424. package/src/isolated/AiPromptsListScreen.isolated.tsx +50 -53
  425. package/src/isolated/DocumentStorageBrowser.isolated.tsx +24 -75
  426. package/src/{widgets/ModelsGridWidget.test.tsx → isolated/ModelsGridWidget.isolated.tsx} +33 -43
  427. package/src/isolated/RecentActivityWidget.isolated.tsx +3 -4
  428. package/src/isolated/UserSecurityScreen.isolated.tsx +1 -5
  429. package/src/isolated/{rpcDualRun.isolated.tsx → adminRpcHooks.isolated.tsx} +37 -119
  430. package/src/isolated/adminWidgets.isolated.tsx +15 -63
  431. package/src/isolated/aiObservabilityDatasets.isolated.tsx +1069 -0
  432. package/src/isolated/aiObservabilityEvaluators.isolated.tsx +879 -0
  433. package/src/isolated/aiObservabilityExperiments.isolated.tsx +1009 -0
  434. package/src/isolated/aiObservabilityPrompts.isolated.tsx +1302 -0
  435. package/src/isolated/aiObservabilityReview.isolated.tsx +873 -0
  436. package/src/isolated/aiObservabilityTraces.isolated.tsx +1049 -0
  437. package/src/isolated/harnessApprovalsScreen.isolated.tsx +1 -3
  438. package/src/isolated/hooks.isolated.tsx +212 -696
  439. package/src/isolated/observabilityFakeApi.isolated.tsx +277 -0
  440. package/src/isolated/useJobsDashboardApi.isolated.tsx +52 -52
  441. package/src/jobs/JobsDashboardScreen.test.tsx +167 -123
  442. package/src/jobs/JobsDashboardScreen.tsx +1 -4
  443. package/src/jobs/JobsDashboardScreenWidget.test.tsx +50 -55
  444. package/src/jobs/JobsDashboardScreenWidget.tsx +1 -2
  445. package/src/jobs/JobsHomeWidget.test.tsx +54 -39
  446. package/src/jobs/JobsHomeWidget.tsx +2 -2
  447. package/src/jobs/JobsJobDetail.test.tsx +103 -59
  448. package/src/jobs/JobsJobDetail.tsx +2 -4
  449. package/src/jobs/jobPayload.ts +1 -1
  450. package/src/jobs/useJobsDashboardApi.test.tsx +111 -113
  451. package/src/jobs/useJobsDashboardApi.tsx +85 -124
  452. package/src/orgs/MemberSecurityPanel.test.tsx +18 -6
  453. package/src/orgs/MemberSecurityPanel.tsx +2 -2
  454. package/src/orgs/OrgDirectoryScreen.test.tsx +146 -102
  455. package/src/orgs/OrgDirectoryScreen.tsx +4 -5
  456. package/src/orgs/OrgManagementScreens.test.tsx +297 -229
  457. package/src/orgs/OrgMembersScreen.tsx +3 -6
  458. package/src/orgs/OrgSettingsScreen.tsx +1 -4
  459. package/src/orgs/OrgSwitcher.test.tsx +132 -65
  460. package/src/orgs/OrgSwitcher.tsx +3 -5
  461. package/src/orgs/normalizeListData.test.ts +1 -1
  462. package/src/orgs/normalizeListData.ts +2 -3
  463. package/src/orgs/orgSwitcherOscillation.test.tsx +103 -60
  464. package/src/orgs/organizationHeaders.ts +9 -0
  465. package/src/orgs/useMemberSecurityApi.ts +1 -1
  466. package/src/orgs/useOrganizationsApi.test.tsx +247 -149
  467. package/src/orgs/useOrganizationsApi.ts +151 -103
  468. package/src/testing/jestNativeMatchers.d.ts +7 -0
  469. package/src/testing/observabilityTestUtils.tsx +70 -0
  470. package/src/testing/{useAdminApiDouble.ts → useAdminModelApiDouble.ts} +4 -4
  471. package/src/types.ts +3 -44
  472. package/src/useAdminBackgroundTask.ts +10 -36
  473. package/src/useAdminConfig.ts +13 -51
  474. package/src/useAdminMigrations.test.tsx +70 -60
  475. package/src/useAdminMigrations.ts +36 -54
  476. package/src/useAdminModelApi.ts +156 -0
  477. package/src/useAdminRoles.ts +43 -117
  478. package/src/useAdminRpc.test.tsx +233 -15
  479. package/src/useAdminRpc.ts +142 -46
  480. package/src/useAdminScripts.ts +71 -146
  481. package/src/useConfigurationApi.ts +25 -81
  482. package/src/useConsentHistory.test.ts +71 -82
  483. package/src/useConsentHistory.ts +18 -68
  484. package/src/useDocumentStorageApi.ts +64 -156
  485. package/src/widgets/AIRequestsScreenWidget.test.tsx +74 -109
  486. package/src/widgets/AIRequestsScreenWidget.tsx +4 -31
  487. package/src/widgets/DocumentsScreenWidget.tsx +2 -9
  488. package/src/widgets/ModelsGridWidget.tsx +5 -6
  489. package/src/widgets/RecentActivityWidget.tsx +3 -3
  490. package/src/widgets/VersionConfigScreenWidget.tsx +1 -2
  491. package/src/widgets/VersionConfigWidget.tsx +2 -2
  492. package/src/widgets/aiObservability/datasets/AiDatasetDetailScreen.tsx +4 -4
  493. package/src/widgets/aiObservability/datasets/AiDatasetsListScreen.tsx +4 -4
  494. package/src/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.test.ts +91 -185
  495. package/src/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.ts +79 -148
  496. package/src/widgets/aiObservability/evaluators/AiEvaluatorDetailScreen.tsx +4 -4
  497. package/src/widgets/aiObservability/evaluators/AiEvaluatorNewScreen.tsx +3 -3
  498. package/src/widgets/aiObservability/evaluators/AiEvaluatorsListScreen.tsx +3 -3
  499. package/src/widgets/aiObservability/evaluators/evaluatorTypes.test.ts +1 -1
  500. package/src/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.test.ts +67 -100
  501. package/src/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.ts +33 -68
  502. package/src/widgets/aiObservability/experiments/AiExperimentNewScreen.tsx +5 -5
  503. package/src/widgets/aiObservability/experiments/AiExperimentResultsScreen.tsx +4 -4
  504. package/src/widgets/aiObservability/experiments/AiExperimentsListScreen.tsx +3 -3
  505. package/src/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.test.ts +62 -125
  506. package/src/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.ts +51 -90
  507. package/src/widgets/aiObservability/prompts/AiPromptEditorScreen.tsx +9 -4
  508. package/src/widgets/aiObservability/prompts/AiPromptEditorView.tsx +17 -9
  509. package/src/widgets/aiObservability/prompts/AiPromptHubView.test.tsx +45 -1
  510. package/src/widgets/aiObservability/prompts/AiPromptPlaygroundView.tsx +5 -1
  511. package/src/widgets/aiObservability/prompts/AiPromptsListScreen.tsx +2 -2
  512. package/src/widgets/aiObservability/prompts/promptTypes.test.ts +1 -1
  513. package/src/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.test.ts +137 -113
  514. package/src/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.ts +69 -118
  515. package/src/widgets/aiObservability/review/AiReviewItemScreen.tsx +8 -3
  516. package/src/widgets/aiObservability/review/AiReviewQueueScreen.tsx +2 -2
  517. package/src/widgets/aiObservability/review/useAiObservabilityReviewApi.test.ts +69 -72
  518. package/src/widgets/aiObservability/review/useAiObservabilityReviewApi.ts +42 -88
  519. package/src/widgets/aiObservability/shell/AiObservabilityChrome.tsx +1 -2
  520. package/src/widgets/aiObservability/shell/AiObservabilityStatusChip.test.tsx +74 -0
  521. package/src/widgets/aiObservability/shell/AiObservabilityStatusChip.tsx +9 -36
  522. package/src/widgets/aiObservability/shell/observabilityRequest.ts +108 -0
  523. package/src/widgets/aiObservability/traces/AiTraceDetailScreen.tsx +8 -3
  524. package/src/widgets/aiObservability/traces/AiTracesListScreen.tsx +4 -4
  525. package/src/widgets/aiObservability/traces/useAiObservabilityTracesApi.test.ts +112 -111
  526. package/src/widgets/aiObservability/traces/useAiObservabilityTracesApi.ts +61 -102
  527. package/src/widgets/builtInFieldWidgets.test.tsx +0 -14
  528. package/src/widgets/harness/HarnessApprovalInbox.test.tsx +0 -5
  529. package/src/widgets/harness/HarnessApprovalInbox.tsx +4 -10
  530. package/src/widgets/harness/useHarnessApprovals.ts +0 -3
  531. package/dist/dynamicHookApi.d.ts +0 -7
  532. package/dist/dynamicHookApi.d.ts.map +0 -1
  533. package/dist/dynamicHookApi.js +0 -4
  534. package/dist/dynamicHookApi.js.map +0 -1
  535. package/dist/orgs/adminModelEndpoints.d.ts +0 -31
  536. package/dist/orgs/adminModelEndpoints.d.ts.map +0 -1
  537. package/dist/orgs/adminModelEndpoints.js +0 -93
  538. package/dist/orgs/adminModelEndpoints.js.map +0 -1
  539. package/dist/useAdminApi.d.ts +0 -59
  540. package/dist/useAdminApi.d.ts.map +0 -1
  541. package/dist/useAdminApi.js +0 -40
  542. package/dist/useAdminApi.js.map +0 -1
  543. package/src/dynamicHookApi.ts +0 -11
  544. package/src/isolated/AIRequestsScreenWidget.isolated.tsx +0 -84
  545. package/src/isolated/aiObservabilityScreens.isolated.tsx +0 -5981
  546. package/src/isolated/useAdminScripts.isolated.tsx +0 -156
  547. package/src/orgs/adminModelEndpoints.test.ts +0 -156
  548. package/src/orgs/adminModelEndpoints.ts +0 -137
  549. package/src/useAdminApi.test.ts +0 -88
  550. package/src/useAdminApi.ts +0 -99
@@ -4,10 +4,16 @@ import {assert} from "chai";
4
4
  import React, {useState} from "react";
5
5
  import {renderWithTheme} from "../../ui/src/test-utils";
6
6
  import {AdminProvider} from "./AdminProvider";
7
- import type {AdminApi} from "./types";
8
- import {useAdminRpc, useAdminRpcMutation, useAdminRpcQuery} from "./useAdminRpc";
7
+ import {
8
+ resetAdminRpcWarningForTests,
9
+ unwrapAdminEnvelope,
10
+ useAdminRpc,
11
+ useAdminRpcMutation,
12
+ useAdminRpcQuery,
13
+ } from "./useAdminRpc";
9
14
 
10
- const api = {} as unknown as AdminApi;
15
+ const jsonResponse = (body: unknown, status = 200): Response =>
16
+ new Response(JSON.stringify(body), {headers: {"Content-Type": "application/json"}, status});
11
17
 
12
18
  const Probe: React.FC<{onValue: (value: unknown) => void; renderValue: () => unknown}> = ({
13
19
  onValue,
@@ -24,25 +30,179 @@ describe("useAdminRpc", () => {
24
30
  globalThis.fetch = originalFetch;
25
31
  });
26
32
 
27
- it("returns undefined rpc outside a fetch-capable provider", () => {
28
- let rpc: unknown;
33
+ it("binds a client inside AdminProvider even without auth options", async () => {
34
+ const calls: {credentials?: RequestCredentials; url: string}[] = [];
35
+ globalThis.fetch = (async (url: string, init?: RequestInit) => {
36
+ calls.push({credentials: init?.credentials, url: String(url)});
37
+ return jsonResponse({ok: true});
38
+ }) as typeof fetch;
39
+ let rpc: ((args: {url: string}) => Promise<unknown>) | undefined;
29
40
  renderWithTheme(
30
- <AdminProvider api={api} apiBase="/admin" routeBase="/admin">
41
+ <AdminProvider apiBase="/admin" apiOrigin="http://api.test" routeBase="/admin">
31
42
  <Probe
32
43
  onValue={(value) => {
33
- rpc = value;
44
+ rpc = value as typeof rpc;
34
45
  }}
35
46
  renderValue={useAdminRpc}
36
47
  />
37
48
  </AdminProvider>
38
49
  );
39
- assert.isUndefined(rpc);
50
+ assert.isFunction(rpc);
51
+ const result = await rpc?.({url: "/admin/config"});
52
+ assert.deepEqual(result, {ok: true});
53
+ assert.deepEqual(calls, [{credentials: undefined, url: "http://api.test/admin/config"}]);
54
+ });
55
+
56
+ it("falls back to a same-origin client outside AdminProvider and warns once", async () => {
57
+ resetAdminRpcWarningForTests();
58
+ const urls: string[] = [];
59
+ globalThis.fetch = (async (url: string) => {
60
+ urls.push(String(url));
61
+ return jsonResponse({ok: true});
62
+ }) as typeof fetch;
63
+ const originalWarn = console.warn;
64
+ const warnings: string[] = [];
65
+ console.warn = (...args: unknown[]): void => {
66
+ warnings.push(String(args[0]));
67
+ };
68
+ const clients: unknown[] = [];
69
+ try {
70
+ renderWithTheme(
71
+ <>
72
+ <Probe onValue={(value) => clients.push(value)} renderValue={useAdminRpc} />
73
+ <Probe onValue={(value) => clients.push(value)} renderValue={useAdminRpc} />
74
+ </>
75
+ );
76
+ } finally {
77
+ console.warn = originalWarn;
78
+ }
79
+ assert.lengthOf(clients, 2);
80
+ assert.strictEqual(clients[0], clients[1]);
81
+ assert.lengthOf(
82
+ warnings.filter((warning) => warning.includes("outside AdminProvider")),
83
+ 1
84
+ );
85
+ const rpc = clients[0] as (args: {url: string}) => Promise<unknown>;
86
+ assert.deepEqual(await rpc({url: "/admin/config"}), {ok: true});
87
+ assert.deepEqual(urls, ["/admin/config"]);
88
+ });
89
+
90
+ it("unwraps single-document envelopes and keeps list envelopes", () => {
91
+ const list = {data: [{_id: "a"}], limit: 20, more: false, page: 1, total: 1};
92
+ assert.strictEqual(unwrapAdminEnvelope(list), list);
93
+ assert.deepEqual(unwrapAdminEnvelope({data: {_id: "a"}}), {_id: "a"});
94
+ assert.deepEqual(unwrapAdminEnvelope({updated: 2}), {updated: 2});
95
+ assert.deepEqual(unwrapAdminEnvelope({data: null}), {data: null});
96
+ assert.deepEqual(unwrapAdminEnvelope([1, 2]), [1, 2]);
97
+ assert.isNull(unwrapAdminEnvelope(null));
98
+ assert.equal(unwrapAdminEnvelope("text"), "text");
99
+ });
100
+
101
+ it("sends query headers, transforms responses, and resolves refetch results", async () => {
102
+ const seen: {headers: Headers; url: string}[] = [];
103
+ let calls = 0;
104
+ globalThis.fetch = (async (url: string, init?: RequestInit) => {
105
+ calls += 1;
106
+ seen.push({headers: new Headers(init?.headers), url: String(url)});
107
+ if (calls === 2) {
108
+ return jsonResponse({title: "Nope"}, 500);
109
+ }
110
+ return jsonResponse({data: {_id: "doc-1", n: calls}});
111
+ }) as typeof fetch;
112
+
113
+ let latest:
114
+ | {
115
+ data?: {_id: string; n: number};
116
+ isError: boolean;
117
+ refetch: () => Promise<{data?: unknown; error?: unknown; isError: boolean}>;
118
+ }
119
+ | undefined;
120
+ const Harness: React.FC = () => {
121
+ const rpc = useAdminRpc();
122
+ latest = useAdminRpcQuery<{_id: string; n: number}>({
123
+ headers: {"X-Organization-Id": "org-1"},
124
+ rpc,
125
+ transformResponse: unwrapAdminEnvelope,
126
+ url: "/admin/foods/doc-1",
127
+ });
128
+ return null;
129
+ };
130
+ renderWithTheme(
131
+ <AdminProvider apiBase="/admin" credentials="same-origin" routeBase="/admin">
132
+ <Harness />
133
+ </AdminProvider>
134
+ );
135
+ await act(async () => {
136
+ await Promise.resolve();
137
+ });
138
+ assert.deepEqual(latest?.data, {_id: "doc-1", n: 1});
139
+ assert.equal(seen[0]?.headers.get("X-Organization-Id"), "org-1");
140
+
141
+ let failedPromise: Promise<{error?: unknown; isError: boolean}> | undefined;
142
+ await act(async () => {
143
+ failedPromise = latest?.refetch();
144
+ });
145
+ await act(async () => {
146
+ await Promise.resolve();
147
+ });
148
+ const failed = await failedPromise;
149
+ assert.isTrue(failed?.isError);
150
+ assert.isTrue(latest?.isError);
151
+
152
+ let succeededPromise: Promise<{data?: unknown; isError: boolean}> | undefined;
153
+ await act(async () => {
154
+ succeededPromise = latest?.refetch();
155
+ });
156
+ await act(async () => {
157
+ await Promise.resolve();
158
+ });
159
+ const succeeded = await succeededPromise;
160
+ assert.isFalse(succeeded?.isError);
161
+ assert.deepEqual(succeeded?.data, {_id: "doc-1", n: 3});
162
+ });
163
+
164
+ it("resolves refetch immediately when the query is skipped", async () => {
165
+ let latest: {refetch: () => Promise<{isError: boolean}>} | undefined;
166
+ const Harness: React.FC = () => {
167
+ latest = useAdminRpcQuery({rpc: undefined, skip: true, url: "/x"});
168
+ return null;
169
+ };
170
+ renderWithTheme(<Harness />);
171
+ let resultPromise: Promise<{isError: boolean}> | undefined;
172
+ await act(async () => {
173
+ resultPromise = latest?.refetch();
174
+ });
175
+ const result = await resultPromise;
176
+ assert.deepEqual(result, {isError: false});
177
+ });
178
+
179
+ it("transforms mutation responses before unwrap resolves", async () => {
180
+ globalThis.fetch = (async () => jsonResponse({data: {_id: "new"}})) as unknown as typeof fetch;
181
+ let trigger:
182
+ | ((args: {method: "POST"; url: string}) => {unwrap: () => Promise<unknown>})
183
+ | undefined;
184
+ const Harness: React.FC = () => {
185
+ const rpc = useAdminRpc();
186
+ const [mutate] = useAdminRpcMutation(rpc, {transformResponse: unwrapAdminEnvelope});
187
+ trigger = mutate;
188
+ return null;
189
+ };
190
+ renderWithTheme(
191
+ <AdminProvider apiBase="/admin" credentials="same-origin" routeBase="/admin">
192
+ <Harness />
193
+ </AdminProvider>
194
+ );
195
+ let created: unknown;
196
+ await act(async () => {
197
+ created = await trigger?.({method: "POST", url: "/admin/foods"}).unwrap();
198
+ });
199
+ assert.deepEqual(created, {_id: "new"});
40
200
  });
41
201
 
42
202
  it("skips queries when rpc is missing or skip is true", () => {
43
203
  let state: {isLoading?: boolean; data?: unknown} | undefined;
44
204
  renderWithTheme(
45
- <AdminProvider api={api} apiBase="/admin" routeBase="/admin">
205
+ <AdminProvider apiBase="/admin" routeBase="/admin">
46
206
  <Probe
47
207
  onValue={(value) => {
48
208
  state = value as {isLoading?: boolean; data?: unknown};
@@ -82,7 +242,6 @@ describe("useAdminRpc", () => {
82
242
 
83
243
  renderWithTheme(
84
244
  <AdminProvider
85
- api={api}
86
245
  apiBase="/admin"
87
246
  credentials="same-origin"
88
247
  getAuthHeaders={() => ({})}
@@ -98,7 +257,7 @@ describe("useAdminRpc", () => {
98
257
  assert.deepEqual(latest.data, {ok: true});
99
258
 
100
259
  await act(async () => {
101
- latest.refetch();
260
+ void latest.refetch();
102
261
  await Promise.resolve();
103
262
  });
104
263
  assert.isOk(latest.error);
@@ -132,7 +291,6 @@ describe("useAdminRpc", () => {
132
291
 
133
292
  renderWithTheme(
134
293
  <AdminProvider
135
- api={api}
136
294
  apiBase="/admin"
137
295
  credentials="same-origin"
138
296
  getAuthHeaders={() => ({})}
@@ -168,6 +326,69 @@ describe("useAdminRpc", () => {
168
326
  assert.isFalse(queryState?.isLoading);
169
327
  });
170
328
 
329
+ it("keeps the previous body, not loading, while a keepPreviousData query pages", async () => {
330
+ let gets = 0;
331
+ let resolveNext: ((response: Response) => void) | undefined;
332
+ globalThis.fetch = (async () => {
333
+ gets += 1;
334
+ if (gets > 1) {
335
+ return await new Promise<Response>((resolve) => {
336
+ resolveNext = resolve;
337
+ });
338
+ }
339
+ return new Response(JSON.stringify({page: 1}), {
340
+ headers: {"Content-Type": "application/json"},
341
+ status: 200,
342
+ });
343
+ }) as unknown as typeof fetch;
344
+
345
+ let setUrl: ((next: string) => void) | undefined;
346
+ let queryState: {data?: {page: number}; isFetching: boolean; isLoading: boolean} | undefined;
347
+ const Harness: React.FC = () => {
348
+ const [url, setNextUrl] = useState("/list?page=1");
349
+ setUrl = setNextUrl;
350
+ const rpc = useAdminRpc();
351
+ queryState = useAdminRpcQuery<{page: number}>({keepPreviousData: true, rpc, url});
352
+ return null;
353
+ };
354
+
355
+ renderWithTheme(
356
+ <AdminProvider
357
+ apiBase="/admin"
358
+ credentials="same-origin"
359
+ getAuthHeaders={() => ({})}
360
+ routeBase="/admin"
361
+ >
362
+ <Harness />
363
+ </AdminProvider>
364
+ );
365
+ await act(async () => {
366
+ await Promise.resolve();
367
+ });
368
+ assert.deepEqual(queryState?.data, {page: 1});
369
+ assert.isFalse(queryState?.isLoading);
370
+
371
+ await act(async () => {
372
+ setUrl?.("/list?page=2");
373
+ });
374
+ // Page 1 stays on screen while page 2 is in flight.
375
+ assert.deepEqual(queryState?.data, {page: 1});
376
+ assert.isFalse(queryState?.isLoading);
377
+ assert.isTrue(queryState?.isFetching);
378
+
379
+ await act(async () => {
380
+ resolveNext?.(
381
+ new Response(JSON.stringify({page: 2}), {
382
+ headers: {"Content-Type": "application/json"},
383
+ status: 200,
384
+ })
385
+ );
386
+ await Promise.resolve();
387
+ });
388
+ assert.deepEqual(queryState?.data, {page: 2});
389
+ assert.isFalse(queryState?.isFetching);
390
+ });
391
+
171
392
  it("reports loading when returning to a URL before the other one finishes", async () => {
172
393
  let gets = 0;
173
394
  globalThis.fetch = (async (_url: string) => {
@@ -193,7 +414,6 @@ describe("useAdminRpc", () => {
193
414
 
194
415
  renderWithTheme(
195
416
  <AdminProvider
196
- api={api}
197
417
  apiBase="/admin"
198
418
  credentials="same-origin"
199
419
  getAuthHeaders={() => ({})}
@@ -261,7 +481,6 @@ describe("useAdminRpc", () => {
261
481
 
262
482
  const rendered = renderWithTheme(
263
483
  <AdminProvider
264
- api={api}
265
484
  apiBase="/admin"
266
485
  credentials="same-origin"
267
486
  getAuthHeaders={() => ({})}
@@ -333,7 +552,6 @@ describe("useAdminRpc", () => {
333
552
 
334
553
  const rendered = renderWithTheme(
335
554
  <AdminProvider
336
- api={api}
337
555
  apiBase="/admin"
338
556
  credentials="same-origin"
339
557
  getAuthHeaders={() => ({})}
@@ -1,6 +1,7 @@
1
+ import {unwrapEnvelope} from "@terreno/syncdb/api";
1
2
  import {useCallback, useEffect, useRef, useState} from "react";
2
3
  import {useAdminContext} from "./adminContext";
3
- import type {AdminRequestArgs} from "./adminRequest";
4
+ import {type AdminRequestArgs, adminRequest} from "./adminRequest";
4
5
  import type {AdminRpc} from "./adminRpc";
5
6
 
6
7
  const invalidationListeners = new WeakMap<AdminRpc, Map<string, Set<() => void>>>();
@@ -33,36 +34,94 @@ const invalidateTags = (rpc: AdminRpc, tags: readonly string[]): void => {
33
34
  }
34
35
  };
35
36
 
36
- export const useAdminRpc = (): AdminRpc | undefined => {
37
+ /**
38
+ * Unauthenticated, same-origin client used when an admin screen renders outside
39
+ * `AdminProvider`. Hosts that need cookies, Bearer headers, or a cross-origin API
40
+ * render `AdminProvider` instead.
41
+ */
42
+ const defaultAdminRpc: AdminRpc = (args: AdminRequestArgs): Promise<unknown> => {
43
+ return adminRequest(args);
44
+ };
45
+
46
+ let warnedMissingProvider = false;
47
+
48
+ /** @internal Test helper — clears the one-time missing-provider warning. */
49
+ export const resetAdminRpcWarningForTests = (): void => {
50
+ warnedMissingProvider = false;
51
+ };
52
+
53
+ /**
54
+ * Host-bound admin fetch client from `AdminProvider`. Outside a provider this
55
+ * returns a plain same-origin client and warns once in development.
56
+ */
57
+ export const useAdminRpc = (): AdminRpc => {
37
58
  const ctx = useAdminContext();
38
- return ctx?.adminRpc;
59
+ if (ctx?.adminRpc) {
60
+ return ctx.adminRpc;
61
+ }
62
+ if (!warnedMissingProvider && typeof __DEV__ !== "undefined" && __DEV__) {
63
+ warnedMissingProvider = true;
64
+ console.warn(
65
+ "[admin] Admin screen rendered outside AdminProvider; requests use same-origin fetch without auth headers."
66
+ );
67
+ }
68
+ return defaultAdminRpc;
39
69
  };
40
70
 
71
+ /**
72
+ * List envelopes (`{data, more, …}`) stay whole, and single-document envelopes
73
+ * (`{data}`) unwrap to the document — the same rule as the syncdb API client.
74
+ * Admin screens read this shape for model CRUD responses.
75
+ */
76
+ export const unwrapAdminEnvelope = (result: unknown): unknown => unwrapEnvelope(result);
77
+
78
+ export interface AdminRpcRefetchResult<T> {
79
+ data?: T;
80
+ error?: unknown;
81
+ isError: boolean;
82
+ }
83
+
41
84
  export interface AdminRpcQueryState<T> {
42
85
  data: T | undefined;
43
86
  error: unknown;
87
+ isError: boolean;
44
88
  isFetching: boolean;
45
89
  isLoading: boolean;
46
- refetch: () => void;
90
+ refetch: () => Promise<AdminRpcRefetchResult<T>>;
91
+ }
92
+
93
+ export interface AdminRpcQueryOptions {
94
+ /** Extra request headers (for example `X-Organization-Id`). */
95
+ headers?: Record<string, string>;
96
+ /**
97
+ * Keep the last body on screen, and `isLoading` false, while a new `url` loads. For paging
98
+ * inside one list, where the table should stay up. Leave it off when the url names another
99
+ * resource (a route change), so a body is never shown under the wrong url.
100
+ */
101
+ keepPreviousData?: boolean;
102
+ pollingInterval?: number;
103
+ providesTags?: readonly string[];
104
+ rpc?: AdminRpc;
105
+ skip?: boolean;
106
+ /** Maps the parsed response before it is stored as `data`. */
107
+ transformResponse?: (result: unknown) => unknown;
108
+ url: string;
47
109
  }
48
110
 
49
111
  /**
50
- * GET-style admin RPC. Skips when `rpc` is missing or `skip` is true so RTK
51
- * dual-run callers can keep a stable hook order.
112
+ * GET-style admin query with tag invalidation, polling, and refetch. Skips when
113
+ * `rpc` is missing or `skip` is true so callers keep a stable hook order.
52
114
  */
53
115
  export const useAdminRpcQuery = <T = unknown>({
116
+ headers,
117
+ keepPreviousData = false,
54
118
  pollingInterval,
55
119
  providesTags = [],
56
120
  rpc,
57
121
  skip = false,
122
+ transformResponse,
58
123
  url,
59
- }: {
60
- pollingInterval?: number;
61
- providesTags?: readonly string[];
62
- rpc?: AdminRpc;
63
- skip?: boolean;
64
- url: string;
65
- }): AdminRpcQueryState<T> => {
124
+ }: AdminRpcQueryOptions): AdminRpcQueryState<T> => {
66
125
  const [data, setData] = useState<T | undefined>(undefined);
67
126
  const [error, setError] = useState<unknown>(null);
68
127
  const [isLoading, setIsLoading] = useState(Boolean(rpc) && !skip);
@@ -70,58 +129,86 @@ export const useAdminRpcQuery = <T = unknown>({
70
129
  const [generation, setGeneration] = useState(0);
71
130
  const [requestUrl, setRequestUrl] = useState(url);
72
131
  const loadedUrlRef = useRef<string | null>(null);
132
+ const pendingRefetchesRef = useRef<Array<(result: AdminRpcRefetchResult<T>) => void>>([]);
133
+ const transformRef = useRef(transformResponse);
134
+ transformRef.current = transformResponse;
73
135
  const tagsKey = providesTags.join("\u0000");
136
+ const headersKey = headers ? JSON.stringify(headers) : "";
74
137
 
75
- // Drop the previous URL's body before paint so a route change cannot show it.
138
+ // Drop the previous URL's body before paint so a route change cannot show it, unless the
139
+ // caller pages through one list and wants the rows to stay until the next page arrives.
76
140
  if (url !== requestUrl) {
77
141
  setRequestUrl(url);
78
- setData(undefined);
79
- setError(null);
80
- setIsLoading(Boolean(rpc) && !skip);
142
+ if (!keepPreviousData) {
143
+ setData(undefined);
144
+ setError(null);
145
+ setIsLoading(Boolean(rpc) && !skip);
146
+ }
81
147
  setIsFetching(Boolean(rpc) && !skip);
82
148
  }
83
149
 
84
- const refetch = useCallback((): void => {
85
- setGeneration((current) => current + 1);
150
+ const settleRefetches = useCallback((result: AdminRpcRefetchResult<T>): void => {
151
+ const pending = pendingRefetchesRef.current;
152
+ pendingRefetchesRef.current = [];
153
+ for (const resolve of pending) {
154
+ resolve(result);
155
+ }
156
+ }, []);
157
+
158
+ const refetch = useCallback((): Promise<AdminRpcRefetchResult<T>> => {
159
+ return new Promise((resolve) => {
160
+ pendingRefetchesRef.current.push(resolve);
161
+ setGeneration((current) => current + 1);
162
+ });
86
163
  }, []);
87
164
 
88
- // Fetch whenever the bound client, URL, or skip flag changes.
165
+ // Fetch whenever the bound client, URL, headers, or skip flag changes.
89
166
  useEffect(() => {
90
167
  if (!rpc || skip) {
91
168
  setIsLoading(false);
92
169
  setIsFetching(false);
170
+ settleRefetches({isError: false});
93
171
  return;
94
172
  }
95
173
  let cancelled = false;
96
174
  const isNewUrl = loadedUrlRef.current !== url;
97
- setIsLoading(isNewUrl);
175
+ // With keepPreviousData, only the first load of all shows as loading.
176
+ setIsLoading(keepPreviousData ? loadedUrlRef.current === null : isNewUrl);
98
177
  setIsFetching(true);
99
- if (isNewUrl) {
178
+ if (isNewUrl && !keepPreviousData) {
100
179
  // The body on screen is gone, so returning to the old URL must load it again.
101
180
  loadedUrlRef.current = null;
102
181
  setData(undefined);
103
182
  }
104
183
  setError(null);
105
- rpc({method: "GET", url})
106
- .then((result) => {
107
- if (!cancelled) {
108
- loadedUrlRef.current = url;
109
- setData(result as T);
110
- setIsLoading(false);
111
- setIsFetching(false);
184
+ const requestHeaders = headersKey
185
+ ? (JSON.parse(headersKey) as Record<string, string>)
186
+ : undefined;
187
+ rpc({headers: requestHeaders, method: "GET", url})
188
+ .then((raw) => {
189
+ if (cancelled) {
190
+ return;
112
191
  }
192
+ const result = (transformRef.current ? transformRef.current(raw) : raw) as T;
193
+ loadedUrlRef.current = url;
194
+ setData(result);
195
+ setIsLoading(false);
196
+ setIsFetching(false);
197
+ settleRefetches({data: result, isError: false});
113
198
  })
114
199
  .catch((caught: unknown) => {
115
- if (!cancelled) {
116
- setError(caught);
117
- setIsLoading(false);
118
- setIsFetching(false);
200
+ if (cancelled) {
201
+ return;
119
202
  }
203
+ setError(caught);
204
+ setIsLoading(false);
205
+ setIsFetching(false);
206
+ settleRefetches({error: caught, isError: true});
120
207
  });
121
208
  return () => {
122
209
  cancelled = true;
123
210
  };
124
- }, [generation, rpc, skip, url]);
211
+ }, [generation, headersKey, keepPreviousData, rpc, settleRefetches, skip, url]);
125
212
 
126
213
  // Refetch mounted queries when a successful RPC mutation invalidates their tags.
127
214
  useEffect(() => {
@@ -141,7 +228,7 @@ export const useAdminRpcQuery = <T = unknown>({
141
228
  };
142
229
  }, [rpc, skip, tagsKey]);
143
230
 
144
- // Re-run the request on the same interval RTK `pollingInterval` uses.
231
+ // Re-run the request every `pollingInterval` milliseconds while mounted.
145
232
  useEffect(() => {
146
233
  if (!rpc || skip || !pollingInterval) {
147
234
  return;
@@ -154,14 +241,26 @@ export const useAdminRpcQuery = <T = unknown>({
154
241
  };
155
242
  }, [pollingInterval, rpc, skip]);
156
243
 
157
- return {data, error, isFetching, isLoading, refetch};
244
+ return {data, error, isError: Boolean(error), isFetching, isLoading, refetch};
245
+ };
246
+
247
+ export interface AdminRpcMutationOptions {
248
+ invalidatesTags?: readonly string[];
249
+ /** Maps the parsed response before `unwrap()` resolves. */
250
+ transformResponse?: (result: unknown) => unknown;
251
+ }
252
+
253
+ export type AdminRpcMutationTrigger = (args: AdminRequestArgs) => {
254
+ unwrap: () => Promise<unknown>;
158
255
  };
159
256
 
257
+ /** Mutation-style admin request: `trigger(args).unwrap()` then invalidate tags. */
160
258
  export const useAdminRpcMutation = (
161
259
  rpc: AdminRpc | undefined,
162
- options: {invalidatesTags?: readonly string[]} = {}
163
- ): [(args: AdminRequestArgs) => {unwrap: () => Promise<unknown>}, {isLoading: boolean}] => {
260
+ options: AdminRpcMutationOptions = {}
261
+ ): [AdminRpcMutationTrigger, {isLoading: boolean}] => {
164
262
  const [isLoading, setIsLoading] = useState(false);
263
+ const {invalidatesTags, transformResponse} = options;
165
264
  const trigger = useCallback(
166
265
  (args: AdminRequestArgs): {unwrap: () => Promise<unknown>} => {
167
266
  return {
@@ -171,19 +270,16 @@ export const useAdminRpcMutation = (
171
270
  }
172
271
  setIsLoading(true);
173
272
  try {
174
- const result = await rpc(args);
175
- invalidateTags(rpc, options.invalidatesTags ?? []);
176
- return result;
273
+ const raw = await rpc(args);
274
+ invalidateTags(rpc, invalidatesTags ?? []);
275
+ return transformResponse ? transformResponse(raw) : raw;
177
276
  } finally {
178
277
  setIsLoading(false);
179
278
  }
180
279
  },
181
280
  };
182
281
  },
183
- [options.invalidatesTags, rpc]
282
+ [invalidatesTags, rpc, transformResponse]
184
283
  );
185
- return [trigger, {isLoading}] as [
186
- (args: AdminRequestArgs) => {unwrap: () => Promise<unknown>},
187
- {isLoading: boolean},
188
- ];
284
+ return [trigger, {isLoading}];
189
285
  };