@terreno/admin-frontend 57.20.0 → 58.0.0-beta.1

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 (561) hide show
  1. package/.ai/guidelines/core.md +6 -5
  2. package/CHANGELOG.md +93 -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 +5 -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 +16 -15
  341. package/src/AdminBreadcrumbs.test.tsx +1 -1
  342. package/src/AdminFieldRenderer.test.tsx +5 -5
  343. package/src/AdminFieldRenderer.tsx +0 -4
  344. package/src/AdminFieldRendererCore.tsx +0 -9
  345. package/src/AdminFilterDrawer.tsx +3 -10
  346. package/src/AdminHome.test.tsx +38 -32
  347. package/src/AdminHome.tsx +3 -8
  348. package/src/AdminMigrations.tsx +2 -7
  349. package/src/AdminMigrationsView.tsx +3 -5
  350. package/src/AdminModelForm.isolated.tsx +38 -202
  351. package/src/AdminModelForm.orgSkip.test.tsx +9 -12
  352. package/src/AdminModelForm.tsx +5 -14
  353. package/src/AdminModelForm.updateDepth.test.tsx +10 -28
  354. package/src/AdminModelList.test.tsx +10 -19
  355. package/src/AdminModelList.tsx +3 -12
  356. package/src/AdminModelTable.test.tsx +57 -111
  357. package/src/AdminModelTable.tsx +10 -36
  358. package/src/AdminModelTable.windowed.test.tsx +33 -45
  359. package/src/AdminNestedArrayField.tsx +1 -10
  360. package/src/AdminNestedObjectField.test.tsx +1 -13
  361. package/src/AdminObjectPicker.tsx +21 -72
  362. package/src/AdminPrimitiveArrayField.test.tsx +5 -33
  363. package/src/AdminPrimitiveArrayField.tsx +1 -5
  364. package/src/AdminProvider.test.tsx +14 -14
  365. package/src/AdminProvider.tsx +5 -9
  366. package/src/AdminRefField.tsx +0 -2
  367. package/src/AdminRolesField.tsx +1 -2
  368. package/src/AdminRolesList.test.tsx +43 -51
  369. package/src/AdminRolesList.tsx +2 -2
  370. package/src/AdminScreenPage.test.tsx +1 -1
  371. package/src/AdminScreenRouter.test.tsx +99 -84
  372. package/src/AdminScreenRouter.tsx +4 -11
  373. package/src/AdminScriptList.test.tsx +23 -24
  374. package/src/AdminScriptList.tsx +4 -7
  375. package/src/AdminScriptRunModal.tsx +2 -4
  376. package/src/AdminShell.test.tsx +23 -40
  377. package/src/AdminShell.tsx +2 -4
  378. package/src/AdminShellLayout.tsx +1 -1
  379. package/src/AdminVersionConfig.test.tsx +67 -81
  380. package/src/AdminVersionConfig.tsx +15 -53
  381. package/src/AnnouncementEditor.test.tsx +141 -163
  382. package/src/AnnouncementEditor.tsx +37 -50
  383. package/src/AnnouncementList.test.tsx +16 -35
  384. package/src/AnnouncementList.tsx +3 -5
  385. package/src/AnnouncementOverview.test.tsx +74 -83
  386. package/src/AnnouncementOverview.tsx +10 -33
  387. package/src/AnnouncementOverviewScreenWidget.test.tsx +4 -5
  388. package/src/AnnouncementOverviewScreenWidget.tsx +1 -5
  389. package/src/CheckboxListEditor.test.tsx +11 -9
  390. package/src/ConfigurationScreen.test.tsx +9 -12
  391. package/src/ConfigurationScreen.tsx +2 -7
  392. package/src/ConsentFormEditor.test.tsx +92 -173
  393. package/src/ConsentFormEditor.tsx +32 -79
  394. package/src/ConsentFormList.test.tsx +13 -28
  395. package/src/ConsentFormList.tsx +3 -5
  396. package/src/ConsentHistory.test.tsx +86 -78
  397. package/src/ConsentHistory.tsx +2 -7
  398. package/src/ConsentResponseViewer.test.tsx +21 -35
  399. package/src/ConsentResponseViewer.tsx +5 -7
  400. package/src/DocumentStorageBrowser.test.tsx +23 -76
  401. package/src/DocumentStorageBrowser.tsx +1 -2
  402. package/src/adminApiQueryParams.ts +1 -1
  403. package/src/adminPageAccess.test.ts +1 -1
  404. package/src/adminRequest.test.ts +3 -3
  405. package/src/adminRequest.ts +20 -108
  406. package/src/adminWindowedTable.test.ts +5 -15
  407. package/src/adminWindowedTable.ts +2 -7
  408. package/src/comms/CommsDashboardScreen.test.tsx +150 -114
  409. package/src/comms/CommsDashboardScreen.tsx +1 -4
  410. package/src/comms/CommsDashboardScreenWidget.test.tsx +33 -35
  411. package/src/comms/CommsDashboardScreenWidget.tsx +1 -2
  412. package/src/comms/CommsMessageDetail.test.tsx +117 -77
  413. package/src/comms/CommsMessageDetail.tsx +1 -8
  414. package/src/comms/useCommsDashboardApi.test.tsx +95 -89
  415. package/src/comms/useCommsDashboardApi.tsx +43 -130
  416. package/src/consentPdfTemplates.ts +1 -0
  417. package/src/index.tsx +14 -2
  418. package/src/isolated/AdminFieldRenderer.isolated.tsx +7 -8
  419. package/src/isolated/AdminFilterDrawer.isolated.tsx +8 -13
  420. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +3 -3
  421. package/src/isolated/AdminHomeWidgets.isolated.tsx +5 -4
  422. package/src/isolated/AdminNestedArrayField.isolated.tsx +11 -27
  423. package/src/isolated/AdminObjectPicker.isolated.tsx +77 -78
  424. package/src/isolated/AdminRefField.isolated.tsx +1 -3
  425. package/src/isolated/AdminScriptList.isolated.tsx +4 -4
  426. package/src/isolated/AdminScriptRunModal.isolated.tsx +3 -54
  427. package/src/isolated/AiPromptEditorScreen.isolated.tsx +157 -122
  428. package/src/isolated/AiPromptsListScreen.isolated.tsx +50 -53
  429. package/src/isolated/DocumentStorageBrowser.isolated.tsx +40 -83
  430. package/src/{widgets/ModelsGridWidget.test.tsx → isolated/ModelsGridWidget.isolated.tsx} +33 -23
  431. package/src/isolated/RecentActivityWidget.isolated.tsx +5 -4
  432. package/src/isolated/UserSecurityScreen.isolated.tsx +1 -5
  433. package/src/isolated/{rpcDualRun.isolated.tsx → adminRpcHooks.isolated.tsx} +37 -112
  434. package/src/isolated/adminWidgets.isolated.tsx +15 -23
  435. package/src/isolated/aiObservabilityDatasets.isolated.tsx +1069 -0
  436. package/src/isolated/aiObservabilityEvaluators.isolated.tsx +879 -0
  437. package/src/isolated/aiObservabilityExperiments.isolated.tsx +1009 -0
  438. package/src/isolated/aiObservabilityPrompts.isolated.tsx +1302 -0
  439. package/src/isolated/aiObservabilityReview.isolated.tsx +873 -0
  440. package/src/isolated/aiObservabilityTraces.isolated.tsx +1049 -0
  441. package/src/isolated/generateConsentHistoryPdf.isolated.ts +30 -10
  442. package/src/isolated/generateConsentPdfsMobile.isolated.ts +24 -3
  443. package/src/isolated/harnessApprovalsScreen.isolated.tsx +1 -3
  444. package/src/isolated/hooks.isolated.tsx +214 -674
  445. package/src/isolated/observabilityFakeApi.isolated.tsx +277 -0
  446. package/src/isolated/useJobsDashboardApi.isolated.tsx +52 -52
  447. package/src/jobs/JobsDashboardScreen.test.tsx +167 -123
  448. package/src/jobs/JobsDashboardScreen.tsx +1 -4
  449. package/src/jobs/JobsDashboardScreenWidget.test.tsx +50 -55
  450. package/src/jobs/JobsDashboardScreenWidget.tsx +1 -2
  451. package/src/jobs/JobsHomeWidget.test.tsx +55 -40
  452. package/src/jobs/JobsHomeWidget.tsx +2 -2
  453. package/src/jobs/JobsJobDetail.test.tsx +104 -60
  454. package/src/jobs/JobsJobDetail.tsx +2 -4
  455. package/src/jobs/jobPayload.ts +1 -1
  456. package/src/jobs/useJobsDashboardApi.test.tsx +111 -113
  457. package/src/jobs/useJobsDashboardApi.tsx +85 -124
  458. package/src/orgs/MemberSecurityPanel.test.tsx +18 -6
  459. package/src/orgs/MemberSecurityPanel.tsx +2 -2
  460. package/src/orgs/OrgDirectoryScreen.test.tsx +146 -102
  461. package/src/orgs/OrgDirectoryScreen.tsx +4 -5
  462. package/src/orgs/OrgManagementScreens.test.tsx +297 -229
  463. package/src/orgs/OrgMembersScreen.tsx +3 -6
  464. package/src/orgs/OrgSettingsScreen.tsx +1 -4
  465. package/src/orgs/OrgSwitcher.test.tsx +132 -65
  466. package/src/orgs/OrgSwitcher.tsx +3 -5
  467. package/src/orgs/normalizeListData.test.ts +1 -1
  468. package/src/orgs/normalizeListData.ts +2 -3
  469. package/src/orgs/orgSwitcherOscillation.test.tsx +103 -60
  470. package/src/orgs/organizationHeaders.ts +9 -0
  471. package/src/orgs/useMemberSecurityApi.ts +1 -1
  472. package/src/orgs/useOrganizationsApi.test.tsx +247 -149
  473. package/src/orgs/useOrganizationsApi.ts +151 -103
  474. package/src/testing/jestNativeMatchers.d.ts +7 -0
  475. package/src/testing/observabilityTestUtils.tsx +70 -0
  476. package/src/testing/{useAdminApiDouble.ts → useAdminModelApiDouble.ts} +6 -5
  477. package/src/types.ts +5 -44
  478. package/src/useAdminBackgroundTask.ts +10 -36
  479. package/src/useAdminConfig.ts +13 -51
  480. package/src/useAdminMigrations.test.tsx +70 -60
  481. package/src/useAdminMigrations.ts +36 -54
  482. package/src/useAdminModelApi.ts +156 -0
  483. package/src/useAdminRoles.ts +43 -117
  484. package/src/useAdminRpc.test.tsx +236 -18
  485. package/src/useAdminRpc.ts +142 -46
  486. package/src/useAdminScripts.ts +71 -146
  487. package/src/useConfigurationApi.ts +25 -81
  488. package/src/useConsentHistory.test.ts +71 -82
  489. package/src/useConsentHistory.ts +18 -68
  490. package/src/useDocumentStorageApi.ts +64 -156
  491. package/src/widgets/AIRequestsScreenWidget.test.tsx +74 -92
  492. package/src/widgets/AIRequestsScreenWidget.tsx +4 -31
  493. package/src/widgets/DocumentsScreenWidget.tsx +2 -9
  494. package/src/widgets/ModelsGridWidget.tsx +5 -6
  495. package/src/widgets/RecentActivityWidget.tsx +3 -3
  496. package/src/widgets/VersionConfigScreenWidget.tsx +1 -2
  497. package/src/widgets/VersionConfigWidget.tsx +2 -2
  498. package/src/widgets/aiObservability/datasets/AiDatasetDetailScreen.tsx +4 -4
  499. package/src/widgets/aiObservability/datasets/AiDatasetDetailView.test.tsx +4 -2
  500. package/src/widgets/aiObservability/datasets/AiDatasetsListScreen.tsx +4 -4
  501. package/src/widgets/aiObservability/datasets/datasetTypes.test.ts +0 -1
  502. package/src/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.test.ts +91 -185
  503. package/src/widgets/aiObservability/datasets/useAiObservabilityDatasetsApi.ts +79 -148
  504. package/src/widgets/aiObservability/evaluators/AiEvaluatorDetailScreen.tsx +4 -4
  505. package/src/widgets/aiObservability/evaluators/AiEvaluatorNewScreen.tsx +3 -3
  506. package/src/widgets/aiObservability/evaluators/AiEvaluatorPanels.test.tsx +89 -23
  507. package/src/widgets/aiObservability/evaluators/AiEvaluatorsListScreen.tsx +3 -3
  508. package/src/widgets/aiObservability/evaluators/evaluatorTypes.test.ts +1 -1
  509. package/src/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.test.ts +67 -100
  510. package/src/widgets/aiObservability/evaluators/useAiObservabilityEvaluatorsApi.ts +33 -68
  511. package/src/widgets/aiObservability/experiments/AiExperimentNewScreen.tsx +5 -5
  512. package/src/widgets/aiObservability/experiments/AiExperimentNewView.test.tsx +4 -0
  513. package/src/widgets/aiObservability/experiments/AiExperimentResultsScreen.tsx +4 -4
  514. package/src/widgets/aiObservability/experiments/AiExperimentsListScreen.tsx +3 -3
  515. package/src/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.test.ts +62 -125
  516. package/src/widgets/aiObservability/experiments/useAiObservabilityExperimentsApi.ts +51 -90
  517. package/src/widgets/aiObservability/prompts/AiPromptEditorScreen.tsx +9 -4
  518. package/src/widgets/aiObservability/prompts/AiPromptEditorView.tsx +17 -9
  519. package/src/widgets/aiObservability/prompts/AiPromptHubView.test.tsx +45 -1
  520. package/src/widgets/aiObservability/prompts/AiPromptPlaygroundView.tsx +5 -1
  521. package/src/widgets/aiObservability/prompts/AiPromptsListScreen.tsx +2 -2
  522. package/src/widgets/aiObservability/prompts/promptTypes.test.ts +1 -1
  523. package/src/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.test.ts +137 -113
  524. package/src/widgets/aiObservability/prompts/useAiObservabilityPromptsApi.ts +69 -118
  525. package/src/widgets/aiObservability/review/AiReviewItemScreen.tsx +8 -3
  526. package/src/widgets/aiObservability/review/AiReviewQueueScreen.tsx +2 -2
  527. package/src/widgets/aiObservability/review/useAiObservabilityReviewApi.test.ts +69 -72
  528. package/src/widgets/aiObservability/review/useAiObservabilityReviewApi.ts +42 -88
  529. package/src/widgets/aiObservability/shell/AiObservabilityChrome.tsx +1 -2
  530. package/src/widgets/aiObservability/shell/AiObservabilityStatusChip.test.tsx +74 -0
  531. package/src/widgets/aiObservability/shell/AiObservabilityStatusChip.tsx +9 -36
  532. package/src/widgets/aiObservability/shell/ObservabilityTable.test.tsx +7 -1
  533. package/src/widgets/aiObservability/shell/observabilityRequest.ts +108 -0
  534. package/src/widgets/aiObservability/traces/AiTraceDetailScreen.tsx +8 -3
  535. package/src/widgets/aiObservability/traces/AiTracesListScreen.tsx +4 -4
  536. package/src/widgets/aiObservability/traces/useAiObservabilityTracesApi.test.ts +112 -111
  537. package/src/widgets/aiObservability/traces/useAiObservabilityTracesApi.ts +61 -102
  538. package/src/widgets/builtInFieldWidgets.test.tsx +3 -4
  539. package/src/widgets/harness/HarnessApprovalInbox.test.tsx +0 -5
  540. package/src/widgets/harness/HarnessApprovalInbox.tsx +4 -10
  541. package/src/widgets/harness/useHarnessApprovals.ts +0 -3
  542. package/dist/dynamicHookApi.d.ts +0 -7
  543. package/dist/dynamicHookApi.d.ts.map +0 -1
  544. package/dist/dynamicHookApi.js +0 -4
  545. package/dist/dynamicHookApi.js.map +0 -1
  546. package/dist/orgs/adminModelEndpoints.d.ts +0 -31
  547. package/dist/orgs/adminModelEndpoints.d.ts.map +0 -1
  548. package/dist/orgs/adminModelEndpoints.js +0 -93
  549. package/dist/orgs/adminModelEndpoints.js.map +0 -1
  550. package/dist/useAdminApi.d.ts +0 -59
  551. package/dist/useAdminApi.d.ts.map +0 -1
  552. package/dist/useAdminApi.js +0 -40
  553. package/dist/useAdminApi.js.map +0 -1
  554. package/src/dynamicHookApi.ts +0 -11
  555. package/src/isolated/AIRequestsScreenWidget.isolated.tsx +0 -84
  556. package/src/isolated/aiObservabilityScreens.isolated.tsx +0 -5972
  557. package/src/isolated/useAdminScripts.isolated.tsx +0 -156
  558. package/src/orgs/adminModelEndpoints.test.ts +0 -156
  559. package/src/orgs/adminModelEndpoints.ts +0 -137
  560. package/src/useAdminApi.test.ts +0 -88
  561. 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};
@@ -57,7 +217,7 @@ describe("useAdminRpc", () => {
57
217
 
58
218
  it("loads GET data, surfaces errors, and refetches", async () => {
59
219
  let calls = 0;
60
- globalThis.fetch = (async () => {
220
+ globalThis.fetch = (async (_url: string) => {
61
221
  calls += 1;
62
222
  if (calls === 1) {
63
223
  return new Response(JSON.stringify({ok: true}), {
@@ -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);
@@ -107,7 +266,7 @@ describe("useAdminRpc", () => {
107
266
  it("drops the previous body and reports loading when the URL changes", async () => {
108
267
  let gets = 0;
109
268
  let resolveNext: ((response: Response) => void) | undefined;
110
- globalThis.fetch = (async () => {
269
+ globalThis.fetch = (async (_url: string) => {
111
270
  gets += 1;
112
271
  if (gets > 1) {
113
272
  return await new Promise<Response>((resolve) => {
@@ -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,9 +326,72 @@ describe("useAdminRpc", () => {
168
326
  assert.isFalse(queryState?.isLoading);
169
327
  });
170
328
 
171
- it("reports loading when returning to a URL before the other one finishes", async () => {
329
+ it("keeps the previous body, not loading, while a keepPreviousData query pages", async () => {
172
330
  let gets = 0;
331
+ let resolveNext: ((response: Response) => void) | undefined;
173
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
+
392
+ it("reports loading when returning to a URL before the other one finishes", async () => {
393
+ let gets = 0;
394
+ globalThis.fetch = (async (_url: string) => {
174
395
  gets += 1;
175
396
  if (gets > 1) {
176
397
  return await new Promise<Response>(() => undefined);
@@ -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
  };