@terreno/admin-frontend 57.3.0 → 57.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/.ai/guidelines/core.md +5 -1
  2. package/README.md +4 -2
  3. package/dist/AdminConflictSheet.d.ts +16 -0
  4. package/dist/AdminConflictSheet.js +52 -0
  5. package/dist/AdminConflictSheet.js.map +1 -0
  6. package/dist/AdminHome.js +2 -1
  7. package/dist/AdminHome.js.map +1 -1
  8. package/dist/AdminMigrations.d.ts +3 -0
  9. package/dist/AdminMigrations.js +19 -0
  10. package/dist/AdminMigrations.js.map +1 -0
  11. package/dist/AdminMigrationsView.d.ts +10 -0
  12. package/dist/AdminMigrationsView.js +94 -0
  13. package/dist/AdminMigrationsView.js.map +1 -0
  14. package/dist/AdminModelForm.js +190 -44
  15. package/dist/AdminModelForm.js.map +1 -1
  16. package/dist/AdminModelTable.js +315 -27
  17. package/dist/AdminModelTable.js.map +1 -1
  18. package/dist/AdminObjectPicker.js +30 -6
  19. package/dist/AdminObjectPicker.js.map +1 -1
  20. package/dist/AdminProvider.d.ts +6 -2
  21. package/dist/AdminProvider.js +29 -7
  22. package/dist/AdminProvider.js.map +1 -1
  23. package/dist/AdminScreenRouter.d.ts +1 -1
  24. package/dist/AdminScreenRouter.js +4 -0
  25. package/dist/AdminScreenRouter.js.map +1 -1
  26. package/dist/AdminShell.d.ts +7 -3
  27. package/dist/AdminShell.js +53 -24
  28. package/dist/AdminShell.js.map +1 -1
  29. package/dist/AdminVersionConfig.js +21 -2
  30. package/dist/AdminVersionConfig.js.map +1 -1
  31. package/dist/AnnouncementEditor.d.ts +45 -0
  32. package/dist/AnnouncementEditor.js +370 -0
  33. package/dist/AnnouncementEditor.js.map +1 -0
  34. package/dist/AnnouncementList.d.ts +15 -0
  35. package/dist/AnnouncementList.js +97 -0
  36. package/dist/AnnouncementList.js.map +1 -0
  37. package/dist/AnnouncementOverview.d.ts +46 -0
  38. package/dist/AnnouncementOverview.js +101 -0
  39. package/dist/AnnouncementOverview.js.map +1 -0
  40. package/dist/AnnouncementOverviewScreenWidget.d.ts +4 -0
  41. package/dist/AnnouncementOverviewScreenWidget.js +28 -0
  42. package/dist/AnnouncementOverviewScreenWidget.js.map +1 -0
  43. package/dist/ConsentFormEditor.js +20 -3
  44. package/dist/ConsentFormEditor.js.map +1 -1
  45. package/dist/DocumentStorageBrowser.js +3 -87
  46. package/dist/DocumentStorageBrowser.js.map +1 -1
  47. package/dist/adminApiQueryParams.d.ts +5 -0
  48. package/dist/adminApiQueryParams.js +25 -0
  49. package/dist/adminApiQueryParams.js.map +1 -0
  50. package/dist/adminConflictSheetStack.d.ts +17 -0
  51. package/dist/adminConflictSheetStack.js +64 -0
  52. package/dist/adminConflictSheetStack.js.map +1 -0
  53. package/dist/adminContext.d.ts +3 -0
  54. package/dist/adminContext.js +6 -0
  55. package/dist/adminContext.js.map +1 -0
  56. package/dist/adminModelListQueryParams.d.ts +3 -2
  57. package/dist/adminModelListQueryParams.js +74 -27
  58. package/dist/adminModelListQueryParams.js.map +1 -1
  59. package/dist/adminRequest.d.ts +51 -0
  60. package/dist/adminRequest.js +161 -0
  61. package/dist/adminRequest.js.map +1 -0
  62. package/dist/adminRpc.d.ts +7 -0
  63. package/dist/adminRpc.js +21 -0
  64. package/dist/adminRpc.js.map +1 -0
  65. package/dist/adminShellNav.d.ts +17 -1
  66. package/dist/adminShellNav.js +41 -9
  67. package/dist/adminShellNav.js.map +1 -1
  68. package/dist/adminWindowRefresh.d.ts +31 -0
  69. package/dist/adminWindowRefresh.js +48 -0
  70. package/dist/adminWindowRefresh.js.map +1 -0
  71. package/dist/adminWindowedTable.d.ts +13 -0
  72. package/dist/adminWindowedTable.js +33 -0
  73. package/dist/adminWindowedTable.js.map +1 -0
  74. package/dist/comms/commsDashboardParams.d.ts +0 -4
  75. package/dist/comms/commsDashboardParams.js +1 -1
  76. package/dist/comms/commsDashboardParams.js.map +1 -1
  77. package/dist/comms/commsMessagePayload.d.ts +2 -1
  78. package/dist/comms/useCommsDashboardApi.d.ts +3 -3
  79. package/dist/comms/useCommsDashboardApi.js +41 -0
  80. package/dist/comms/useCommsDashboardApi.js.map +1 -1
  81. package/dist/index.d.ts +24 -2
  82. package/dist/index.js +23 -1
  83. package/dist/index.js.map +1 -1
  84. package/dist/isAuditLogModel.d.ts +2 -0
  85. package/dist/isAuditLogModel.js +8 -0
  86. package/dist/isAuditLogModel.js.map +1 -0
  87. package/dist/jobs/JobsDashboardScreen.d.ts +10 -0
  88. package/dist/jobs/JobsDashboardScreen.js +155 -0
  89. package/dist/jobs/JobsDashboardScreen.js.map +1 -0
  90. package/dist/jobs/JobsDashboardScreenWidget.d.ts +4 -0
  91. package/dist/jobs/JobsDashboardScreenWidget.js +11 -0
  92. package/dist/jobs/JobsDashboardScreenWidget.js.map +1 -0
  93. package/dist/jobs/JobsHomeWidget.d.ts +4 -0
  94. package/dist/jobs/JobsHomeWidget.js +21 -0
  95. package/dist/jobs/JobsHomeWidget.js.map +1 -0
  96. package/dist/jobs/JobsJobDetail.d.ts +8 -0
  97. package/dist/jobs/JobsJobDetail.js +78 -0
  98. package/dist/jobs/JobsJobDetail.js.map +1 -0
  99. package/dist/jobs/JobsStatusBadge.d.ts +5 -0
  100. package/dist/jobs/JobsStatusBadge.js +16 -0
  101. package/dist/jobs/JobsStatusBadge.js.map +1 -0
  102. package/dist/jobs/jobPayload.d.ts +62 -0
  103. package/dist/jobs/jobPayload.js +54 -0
  104. package/dist/jobs/jobPayload.js.map +1 -0
  105. package/dist/jobs/jobsDashboardParams.d.ts +11 -0
  106. package/dist/jobs/jobsDashboardParams.js +70 -0
  107. package/dist/jobs/jobsDashboardParams.js.map +1 -0
  108. package/dist/jobs/useJobsDashboardApi.d.ts +60 -0
  109. package/dist/jobs/useJobsDashboardApi.js +88 -0
  110. package/dist/jobs/useJobsDashboardApi.js.map +1 -0
  111. package/dist/jobs/useJobsDashboardUrlFilters.d.ts +5 -0
  112. package/dist/jobs/useJobsDashboardUrlFilters.js +16 -0
  113. package/dist/jobs/useJobsDashboardUrlFilters.js.map +1 -0
  114. package/dist/orgs/OrgDirectoryScreen.d.ts +16 -0
  115. package/dist/orgs/OrgDirectoryScreen.js +81 -0
  116. package/dist/orgs/OrgDirectoryScreen.js.map +1 -0
  117. package/dist/orgs/OrgMembersScreen.d.ts +9 -0
  118. package/dist/orgs/OrgMembersScreen.js +115 -0
  119. package/dist/orgs/OrgMembersScreen.js.map +1 -0
  120. package/dist/orgs/OrgSettingsScreen.d.ts +9 -0
  121. package/dist/orgs/OrgSettingsScreen.js +80 -0
  122. package/dist/orgs/OrgSettingsScreen.js.map +1 -0
  123. package/dist/orgs/OrgSwitcher.d.ts +8 -0
  124. package/dist/orgs/OrgSwitcher.js +58 -0
  125. package/dist/orgs/OrgSwitcher.js.map +1 -0
  126. package/dist/orgs/adminModelEndpoints.d.ts +18 -0
  127. package/dist/orgs/adminModelEndpoints.js +73 -0
  128. package/dist/orgs/adminModelEndpoints.js.map +1 -0
  129. package/dist/orgs/normalizeListData.d.ts +9 -0
  130. package/dist/orgs/normalizeListData.js +8 -0
  131. package/dist/orgs/normalizeListData.js.map +1 -0
  132. package/dist/orgs/organizationSettings.d.ts +17 -0
  133. package/dist/orgs/organizationSettings.js +6 -0
  134. package/dist/orgs/organizationSettings.js.map +1 -0
  135. package/dist/orgs/shouldSkipOrgScopedAdminQuery.d.ts +4 -0
  136. package/dist/orgs/shouldSkipOrgScopedAdminQuery.js +2 -0
  137. package/dist/orgs/shouldSkipOrgScopedAdminQuery.js.map +1 -0
  138. package/dist/orgs/sortOrganizations.d.ts +6 -0
  139. package/dist/orgs/sortOrganizations.js +9 -0
  140. package/dist/orgs/sortOrganizations.js.map +1 -0
  141. package/dist/orgs/useOrgContext.d.ts +20 -0
  142. package/dist/orgs/useOrgContext.js +57 -0
  143. package/dist/orgs/useOrgContext.js.map +1 -0
  144. package/dist/orgs/useOrganizationsApi.d.ts +14 -0
  145. package/dist/orgs/useOrganizationsApi.js +103 -0
  146. package/dist/orgs/useOrganizationsApi.js.map +1 -0
  147. package/dist/pdfUtils.d.ts +0 -2
  148. package/dist/pdfUtils.js +2 -2
  149. package/dist/pdfUtils.js.map +1 -1
  150. package/dist/types.d.ts +100 -4
  151. package/dist/types.js.map +1 -1
  152. package/dist/useAdminApi.js +7 -61
  153. package/dist/useAdminApi.js.map +1 -1
  154. package/dist/useAdminBackgroundTask.d.ts +1 -1
  155. package/dist/useAdminBackgroundTask.js +18 -3
  156. package/dist/useAdminBackgroundTask.js.map +1 -1
  157. package/dist/useAdminConfig.js +16 -1
  158. package/dist/useAdminConfig.js.map +1 -1
  159. package/dist/useAdminMigrations.d.ts +40 -0
  160. package/dist/useAdminMigrations.js +43 -0
  161. package/dist/useAdminMigrations.js.map +1 -0
  162. package/dist/useAdminRoles.d.ts +1 -0
  163. package/dist/useAdminRoles.js +34 -0
  164. package/dist/useAdminRoles.js.map +1 -1
  165. package/dist/useAdminRpc.d.ts +28 -0
  166. package/dist/useAdminRpc.js +128 -0
  167. package/dist/useAdminRpc.js.map +1 -0
  168. package/dist/useAdminScripts.js +51 -0
  169. package/dist/useAdminScripts.js.map +1 -1
  170. package/dist/useConfigurationApi.js +23 -0
  171. package/dist/useConfigurationApi.js.map +1 -1
  172. package/dist/useConsentHistory.js +9 -1
  173. package/dist/useConsentHistory.js.map +1 -1
  174. package/dist/useDocumentStorageApi.js +72 -0
  175. package/dist/useDocumentStorageApi.js.map +1 -1
  176. package/dist/widgets/AIRequestsScreenWidget.js +17 -7
  177. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -1
  178. package/dist/widgets/ModelsGridWidget.js +10 -3
  179. package/dist/widgets/ModelsGridWidget.js.map +1 -1
  180. package/dist/widgets/RecentActivityWidget.js +11 -4
  181. package/dist/widgets/RecentActivityWidget.js.map +1 -1
  182. package/dist/widgets/builtInWidgets.js +5 -9
  183. package/dist/widgets/builtInWidgets.js.map +1 -1
  184. package/dist/widgets/homeWidgetUtils.d.ts +0 -1
  185. package/dist/widgets/homeWidgetUtils.js +0 -8
  186. package/dist/widgets/homeWidgetUtils.js.map +1 -1
  187. package/package.json +6 -4
  188. package/src/AdminActionMenu.test.tsx +167 -0
  189. package/src/AdminBreadcrumbs.test.tsx +21 -1
  190. package/src/AdminConflictSheet.test.tsx +173 -0
  191. package/src/AdminConflictSheet.tsx +102 -0
  192. package/src/AdminHome.test.tsx +10 -11
  193. package/src/AdminHome.tsx +2 -4
  194. package/src/AdminMigrations.tsx +45 -0
  195. package/src/AdminMigrationsView.tsx +225 -0
  196. package/src/{AdminModelForm.test.tsx → AdminModelForm.isolated.tsx} +461 -154
  197. package/src/AdminModelForm.orgSkip.test.tsx +81 -0
  198. package/src/AdminModelForm.tsx +227 -56
  199. package/src/AdminModelForm.updateDepth.test.tsx +427 -0
  200. package/src/AdminModelList.test.tsx +12 -2
  201. package/src/AdminModelTable.test.tsx +560 -57
  202. package/src/AdminModelTable.tsx +430 -73
  203. package/src/AdminModelTable.windowed.test.tsx +897 -0
  204. package/src/AdminObjectPicker.tsx +32 -6
  205. package/src/AdminPrimitiveArrayField.test.tsx +178 -0
  206. package/src/AdminProvider.test.tsx +213 -3
  207. package/src/AdminProvider.tsx +39 -7
  208. package/src/AdminRolesList.test.tsx +197 -0
  209. package/src/AdminScreenRouter.test.tsx +393 -36
  210. package/src/AdminScreenRouter.tsx +6 -1
  211. package/src/AdminScriptList.test.tsx +180 -0
  212. package/src/AdminShell.test.tsx +595 -1
  213. package/src/AdminShell.tsx +110 -22
  214. package/src/AdminVersionConfig.tsx +31 -3
  215. package/src/AnnouncementEditor.test.tsx +603 -0
  216. package/src/AnnouncementEditor.tsx +673 -0
  217. package/src/AnnouncementList.test.tsx +198 -0
  218. package/src/AnnouncementList.tsx +214 -0
  219. package/src/AnnouncementOverview.test.tsx +325 -0
  220. package/src/AnnouncementOverview.tsx +325 -0
  221. package/src/AnnouncementOverviewScreenWidget.test.tsx +69 -0
  222. package/src/AnnouncementOverviewScreenWidget.tsx +51 -0
  223. package/src/CheckboxListEditor.test.tsx +8 -1
  224. package/src/ConsentFormEditor.test.tsx +28 -29
  225. package/src/ConsentFormEditor.tsx +27 -3
  226. package/src/ConsentFormList.test.tsx +12 -11
  227. package/src/ConsentResponseViewer.test.tsx +10 -11
  228. package/src/DocumentStorageBrowser.tsx +2 -139
  229. package/src/adminApiQueryParams.ts +33 -0
  230. package/src/adminConflictSheetStack.ts +87 -0
  231. package/src/adminContext.ts +8 -0
  232. package/src/adminModelListQueryParams.test.ts +60 -1
  233. package/src/adminModelListQueryParams.ts +89 -30
  234. package/src/adminRequest.test.ts +216 -0
  235. package/src/adminRequest.ts +213 -0
  236. package/src/adminRpc.test.ts +18 -0
  237. package/src/adminRpc.ts +31 -0
  238. package/src/adminScriptsHarness.test.ts +21 -0
  239. package/src/adminShellNav.test.ts +72 -6
  240. package/src/adminShellNav.ts +55 -10
  241. package/src/adminWindowRefresh.test.ts +65 -0
  242. package/src/adminWindowRefresh.ts +76 -0
  243. package/src/adminWindowedTable.test.ts +90 -0
  244. package/src/adminWindowedTable.ts +55 -0
  245. package/src/comms/CommsDashboardScreen.test.tsx +2 -2
  246. package/src/comms/commsDashboardParams.ts +1 -1
  247. package/src/comms/commsMessagePayload.ts +1 -1
  248. package/src/comms/useCommsDashboardApi.tsx +57 -4
  249. package/src/index.tsx +79 -1
  250. package/src/isAuditLogModel.test.ts +14 -0
  251. package/src/isAuditLogModel.ts +11 -0
  252. package/src/isolated/AIRequestsScreenWidget.isolated.tsx +84 -0
  253. package/src/isolated/AdminFieldRenderer.isolated.tsx +160 -0
  254. package/src/isolated/AdminFilterDrawer.isolated.tsx +215 -2
  255. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +172 -0
  256. package/src/isolated/AdminHomeWidgets.isolated.tsx +73 -0
  257. package/src/isolated/AdminObjectPicker.isolated.tsx +7 -0
  258. package/src/isolated/AdminScriptList.isolated.tsx +124 -0
  259. package/src/isolated/AdminScriptRunModal.isolated.tsx +274 -4
  260. package/src/isolated/DocumentStorageBrowser.isolated.tsx +13 -0
  261. package/src/isolated/RecentActivityWidget.isolated.tsx +138 -0
  262. package/src/isolated/adminWidgets.isolated.tsx +190 -0
  263. package/src/isolated/generateConsentHistoryPdf.isolated.ts +251 -0
  264. package/src/isolated/generateConsentPdfMobile.isolated.ts +87 -0
  265. package/src/isolated/generateConsentPdfsMobile.isolated.ts +129 -0
  266. package/src/isolated/hooks.isolated.tsx +245 -3
  267. package/src/isolated/rpcDualRun.isolated.tsx +449 -0
  268. package/src/isolated/useAdminScripts.isolated.tsx +156 -0
  269. package/src/isolated/useJobsDashboardApi.isolated.tsx +60 -0
  270. package/src/jobs/JobsDashboardScreen.test.tsx +310 -0
  271. package/src/jobs/JobsDashboardScreen.tsx +461 -0
  272. package/src/jobs/JobsDashboardScreenWidget.test.tsx +83 -0
  273. package/src/jobs/JobsDashboardScreenWidget.tsx +20 -0
  274. package/src/jobs/JobsHomeWidget.test.tsx +92 -0
  275. package/src/jobs/JobsHomeWidget.tsx +53 -0
  276. package/src/jobs/JobsJobDetail.test.tsx +253 -0
  277. package/src/jobs/JobsJobDetail.tsx +278 -0
  278. package/src/jobs/JobsStatusBadge.tsx +16 -0
  279. package/src/jobs/jobPayload.ts +114 -0
  280. package/src/jobs/jobsDashboardParams.test.ts +80 -0
  281. package/src/jobs/jobsDashboardParams.ts +84 -0
  282. package/src/jobs/useJobsDashboardApi.test.tsx +152 -0
  283. package/src/jobs/useJobsDashboardApi.tsx +132 -0
  284. package/src/jobs/useJobsDashboardUrlFilters.test.tsx +31 -0
  285. package/src/jobs/useJobsDashboardUrlFilters.tsx +31 -0
  286. package/src/orgs/OrgDirectoryScreen.test.tsx +184 -0
  287. package/src/orgs/OrgDirectoryScreen.tsx +200 -0
  288. package/src/orgs/OrgManagementScreens.test.tsx +270 -0
  289. package/src/orgs/OrgMembersScreen.tsx +254 -0
  290. package/src/orgs/OrgSettingsScreen.tsx +145 -0
  291. package/src/orgs/OrgSwitcher.test.tsx +145 -0
  292. package/src/orgs/OrgSwitcher.tsx +101 -0
  293. package/src/orgs/adminModelEndpoints.test.ts +156 -0
  294. package/src/orgs/adminModelEndpoints.ts +96 -0
  295. package/src/orgs/normalizeListData.test.ts +17 -0
  296. package/src/orgs/normalizeListData.ts +13 -0
  297. package/src/orgs/orgSwitcherOscillation.test.tsx +107 -0
  298. package/src/orgs/organizationSettings.test.ts +11 -0
  299. package/src/orgs/organizationSettings.ts +22 -0
  300. package/src/orgs/shouldSkipOrgScopedAdminQuery.test.ts +22 -0
  301. package/src/orgs/shouldSkipOrgScopedAdminQuery.ts +7 -0
  302. package/src/orgs/sortOrganizations.test.ts +13 -0
  303. package/src/orgs/sortOrganizations.ts +14 -0
  304. package/src/orgs/useOrgContext.test.tsx +94 -0
  305. package/src/orgs/useOrgContext.tsx +90 -0
  306. package/src/orgs/useOrganizationsApi.test.tsx +165 -0
  307. package/src/orgs/useOrganizationsApi.ts +118 -0
  308. package/src/pdfUtils.test.ts +37 -0
  309. package/src/pdfUtils.ts +2 -2
  310. package/src/testing/useAdminApiDouble.ts +70 -0
  311. package/src/types.ts +92 -4
  312. package/src/useAdminApi.test.ts +88 -0
  313. package/src/useAdminApi.ts +7 -65
  314. package/src/useAdminBackgroundTask.ts +20 -4
  315. package/src/useAdminConfig.ts +20 -2
  316. package/src/useAdminMigrations.test.tsx +75 -0
  317. package/src/useAdminMigrations.ts +77 -0
  318. package/src/useAdminRoles.test.ts +28 -0
  319. package/src/useAdminRoles.ts +40 -0
  320. package/src/useAdminRpc.test.tsx +250 -0
  321. package/src/useAdminRpc.ts +173 -0
  322. package/src/useAdminScripts.ts +67 -0
  323. package/src/useConfigurationApi.ts +24 -0
  324. package/src/useConsentHistory.ts +15 -2
  325. package/src/useDocumentStorageApi.ts +77 -0
  326. package/src/widgets/AIRequestsScreenWidget.test.tsx +154 -0
  327. package/src/widgets/AIRequestsScreenWidget.tsx +21 -7
  328. package/src/widgets/ModelsGridWidget.test.tsx +91 -0
  329. package/src/widgets/ModelsGridWidget.tsx +11 -1
  330. package/src/widgets/RecentActivityWidget.tsx +10 -3
  331. package/src/widgets/builtInFieldWidgets.test.tsx +166 -0
  332. package/src/widgets/builtInWidgets.ts +6 -0
  333. package/src/widgets/homeWidgetUtils.ts +0 -9
  334. package/src/widgets/pluginWidgets.test.tsx +10 -1
@@ -0,0 +1,165 @@
1
+ import {describe, it, mock} from "bun:test";
2
+ import {renderHook} from "@testing-library/react-native";
3
+ import {assert} from "chai";
4
+ import type {AdminApi, EndpointBuilder} from "../types";
5
+ import {useOrganizationsApi} from "./useOrganizationsApi";
6
+
7
+ interface CapturedQuery {
8
+ body?: Record<string, unknown>;
9
+ headers?: Record<string, string>;
10
+ method: string;
11
+ url: string;
12
+ }
13
+
14
+ interface CapturedEndpoint {
15
+ invalidatesTags?: string[] | unknown;
16
+ providesTags?: unknown;
17
+ query: (arg: never) => CapturedQuery;
18
+ }
19
+
20
+ /**
21
+ * Stands in for the host RTK Query API. `injectEndpoints` is invoked eagerly so the
22
+ * endpoint definitions can be asserted, then hook names are returned the way RTK Query
23
+ * generates them from endpoint keys.
24
+ */
25
+ const createApiDouble = (): {
26
+ addTagTypes: string[][];
27
+ api: AdminApi;
28
+ endpoints: Record<string, CapturedEndpoint>;
29
+ } => {
30
+ const endpoints: Record<string, CapturedEndpoint> = {};
31
+ const addTagTypes: string[][] = [];
32
+ const api = {
33
+ enhanceEndpoints: ({addTagTypes: tags}: {addTagTypes: string[]}) => {
34
+ addTagTypes.push(tags);
35
+ return api;
36
+ },
37
+ injectEndpoints: ({
38
+ endpoints: build,
39
+ }: {
40
+ endpoints: (builder: EndpointBuilder) => Record<string, CapturedEndpoint>;
41
+ }) => {
42
+ const builder = {
43
+ mutation: (spec: CapturedEndpoint) => spec,
44
+ query: (spec: CapturedEndpoint) => spec,
45
+ } as unknown as EndpointBuilder;
46
+ Object.assign(endpoints, build(builder));
47
+ return {
48
+ useOrgCreateMutation: mock(() => [mock(() => ({})), {isLoading: false}]),
49
+ useOrgDeleteMutation: mock(() => [mock(() => ({})), {isLoading: false}]),
50
+ useOrgListQuery: mock(() => ({isLoading: false})),
51
+ useOrgMemberAttachMutation: mock(() => [mock(() => ({})), {isLoading: false}]),
52
+ useOrgMemberRemoveMutation: mock(() => [mock(() => ({})), {isLoading: false}]),
53
+ useOrgMembersQuery: mock(() => ({isLoading: false})),
54
+ useOrgMemberUpdateMutation: mock(() => [mock(() => ({})), {isLoading: false}]),
55
+ useOrgMineQuery: mock(() => ({isLoading: false})),
56
+ useOrgReadQuery: mock(() => ({isLoading: false})),
57
+ useOrgUpdateMutation: mock(() => [mock(() => ({})), {isLoading: false}]),
58
+ };
59
+ },
60
+ } as unknown as AdminApi;
61
+ return {addTagTypes, api, endpoints};
62
+ };
63
+
64
+ describe("useOrganizationsApi", () => {
65
+ it("injects every organization endpoint against the base path", () => {
66
+ const {addTagTypes, api, endpoints} = createApiDouble();
67
+ const {result} = renderHook(() => useOrganizationsApi(api, "/custom-orgs", "org-ctx"));
68
+
69
+ assert.deepEqual(addTagTypes[0], ["organizations", "organization-members"]);
70
+ assert.deepEqual(endpoints.orgCreate.query({name: "Acme"} as never), {
71
+ body: {name: "Acme"},
72
+ method: "POST",
73
+ url: "/custom-orgs",
74
+ });
75
+ assert.deepEqual(endpoints.orgDelete.query("org-1" as never), {
76
+ method: "DELETE",
77
+ url: "/custom-orgs/org-1",
78
+ });
79
+ assert.deepEqual(endpoints.orgList.query(undefined as never), {
80
+ method: "GET",
81
+ url: "/custom-orgs",
82
+ });
83
+ assert.deepEqual(endpoints.orgMine.query(undefined as never), {
84
+ method: "GET",
85
+ url: "/custom-orgs/mine",
86
+ });
87
+ assert.deepEqual(endpoints.orgRead.query("org-1" as never), {
88
+ headers: {"X-Organization-Id": "org-1"},
89
+ method: "GET",
90
+ url: "/custom-orgs/org-1",
91
+ });
92
+ assert.deepEqual(endpoints.orgUpdate.query({body: {name: "Acme"}, id: "org-1"} as never), {
93
+ body: {name: "Acme"},
94
+ headers: {"X-Organization-Id": "org-1"},
95
+ method: "PATCH",
96
+ url: "/custom-orgs/org-1",
97
+ });
98
+ assert.deepEqual(
99
+ endpoints.orgMemberAttach.query({body: {email: "a@b.com"}, id: "org-1"} as never),
100
+ {
101
+ body: {email: "a@b.com"},
102
+ headers: {"X-Organization-Id": "org-1"},
103
+ method: "POST",
104
+ url: "/custom-orgs/org-1/members",
105
+ }
106
+ );
107
+ assert.deepEqual(endpoints.orgMembers.query("org-1" as never), {
108
+ headers: {"X-Organization-Id": "org-1"},
109
+ method: "GET",
110
+ url: "/custom-orgs/org-1/members",
111
+ });
112
+ assert.deepEqual(
113
+ endpoints.orgMemberUpdate.query({
114
+ body: {roleName: "member"},
115
+ id: "org-1",
116
+ memberId: "membership-1",
117
+ } as never),
118
+ {
119
+ body: {roleName: "member"},
120
+ headers: {"X-Organization-Id": "org-1"},
121
+ method: "PATCH",
122
+ url: "/custom-orgs/org-1/members/membership-1",
123
+ }
124
+ );
125
+ assert.deepEqual(
126
+ endpoints.orgMemberRemove.query({
127
+ body: {},
128
+ id: "org-1",
129
+ memberId: "membership-1",
130
+ } as never),
131
+ {
132
+ headers: {"X-Organization-Id": "org-1"},
133
+ method: "DELETE",
134
+ url: "/custom-orgs/org-1/members/membership-1",
135
+ }
136
+ );
137
+
138
+ assert.exists(result.current.useCreateMutation);
139
+ assert.exists(result.current.useDeleteMutation);
140
+ assert.exists(result.current.useListQuery);
141
+ assert.exists(result.current.useMemberAttachMutation);
142
+ assert.exists(result.current.useMemberRemoveMutation);
143
+ assert.exists(result.current.useMembersQuery);
144
+ assert.exists(result.current.useMemberUpdateMutation);
145
+ assert.exists(result.current.useMineQuery);
146
+ assert.exists(result.current.useReadQuery);
147
+ assert.exists(result.current.useUpdateMutation);
148
+ });
149
+
150
+ it("tags collection and membership endpoints for cache invalidation", () => {
151
+ const {api, endpoints} = createApiDouble();
152
+ renderHook(() => useOrganizationsApi(api));
153
+
154
+ assert.deepEqual(endpoints.orgCreate.invalidatesTags, ["organizations"]);
155
+ assert.deepEqual(endpoints.orgDelete.invalidatesTags, ["organizations"]);
156
+ assert.deepEqual(endpoints.orgUpdate.invalidatesTags, ["organizations"]);
157
+ assert.deepEqual(endpoints.orgList.providesTags, ["organizations"]);
158
+ assert.deepEqual(endpoints.orgMine.providesTags, ["organizations"]);
159
+ assert.deepEqual(endpoints.orgRead.providesTags, ["organizations"]);
160
+ assert.deepEqual(endpoints.orgMemberAttach.invalidatesTags, ["organization-members"]);
161
+ assert.deepEqual(endpoints.orgMemberRemove.invalidatesTags, ["organization-members"]);
162
+ assert.deepEqual(endpoints.orgMemberUpdate.invalidatesTags, ["organization-members"]);
163
+ assert.deepEqual(endpoints.orgMembers.providesTags, ["organization-members"]);
164
+ });
165
+ });
@@ -0,0 +1,118 @@
1
+ import {useMemo} from "react";
2
+ import {asDynamicHookApi} from "../dynamicHookApi";
3
+ import type {AdminApi, EndpointBuilder} from "../types";
4
+
5
+ interface OrganizationMutation {
6
+ id: string;
7
+ body: Record<string, unknown>;
8
+ }
9
+
10
+ interface MembershipMutation extends OrganizationMutation {
11
+ memberId: string;
12
+ }
13
+
14
+ const organizationHeaders = (organizationId?: string): Record<string, string> | undefined => {
15
+ if (!organizationId) {
16
+ return undefined;
17
+ }
18
+ return {"X-Organization-Id": organizationId};
19
+ };
20
+
21
+ /** RTK Query hooks for the framework OrgsApp routes. */
22
+ export const useOrganizationsApi = (api: AdminApi, basePath = "/orgs", organizationId?: string) => {
23
+ const enhancedApi = useMemo(
24
+ () =>
25
+ api
26
+ .enhanceEndpoints({addTagTypes: ["organizations", "organization-members"]})
27
+ .injectEndpoints({
28
+ endpoints: (build: EndpointBuilder) => ({
29
+ orgCreate: build.mutation({
30
+ invalidatesTags: ["organizations"],
31
+ query: (body: Record<string, unknown>) => ({
32
+ body,
33
+ method: "POST",
34
+ url: basePath,
35
+ }),
36
+ }),
37
+ orgDelete: build.mutation({
38
+ invalidatesTags: ["organizations"],
39
+ query: (id: string) => ({method: "DELETE", url: `${basePath}/${id}`}),
40
+ }),
41
+ orgList: build.query({
42
+ providesTags: ["organizations"],
43
+ query: () => ({method: "GET", url: basePath}),
44
+ }),
45
+ orgMemberAttach: build.mutation({
46
+ invalidatesTags: ["organization-members"],
47
+ query: ({body, id}: OrganizationMutation) => ({
48
+ body,
49
+ headers: organizationHeaders(id),
50
+ method: "POST",
51
+ url: `${basePath}/${id}/members`,
52
+ }),
53
+ }),
54
+ orgMemberRemove: build.mutation({
55
+ invalidatesTags: ["organization-members"],
56
+ query: ({id, memberId}: MembershipMutation) => ({
57
+ headers: organizationHeaders(id),
58
+ method: "DELETE",
59
+ url: `${basePath}/${id}/members/${memberId}`,
60
+ }),
61
+ }),
62
+ orgMembers: build.query({
63
+ providesTags: ["organization-members"],
64
+ query: (id: string) => ({
65
+ headers: organizationHeaders(id),
66
+ method: "GET",
67
+ url: `${basePath}/${id}/members`,
68
+ }),
69
+ }),
70
+ orgMemberUpdate: build.mutation({
71
+ invalidatesTags: ["organization-members"],
72
+ query: ({body, id, memberId}: MembershipMutation) => ({
73
+ body,
74
+ headers: organizationHeaders(id),
75
+ method: "PATCH",
76
+ url: `${basePath}/${id}/members/${memberId}`,
77
+ }),
78
+ }),
79
+ orgMine: build.query({
80
+ providesTags: ["organizations"],
81
+ query: () => ({method: "GET", url: `${basePath}/mine`}),
82
+ }),
83
+ orgRead: build.query({
84
+ providesTags: ["organizations"],
85
+ query: (id: string) => ({
86
+ headers: organizationHeaders(id),
87
+ method: "GET",
88
+ url: `${basePath}/${id}`,
89
+ }),
90
+ }),
91
+ orgUpdate: build.mutation({
92
+ invalidatesTags: ["organizations"],
93
+ query: ({body, id}: OrganizationMutation) => ({
94
+ body,
95
+ headers: organizationHeaders(id),
96
+ method: "PATCH",
97
+ url: `${basePath}/${id}`,
98
+ }),
99
+ }),
100
+ }),
101
+ overrideExisting: true,
102
+ }),
103
+ [api, basePath, organizationId]
104
+ );
105
+ const hooks = asDynamicHookApi(enhancedApi);
106
+ return {
107
+ useCreateMutation: hooks.useOrgCreateMutation,
108
+ useDeleteMutation: hooks.useOrgDeleteMutation,
109
+ useListQuery: hooks.useOrgListQuery,
110
+ useMemberAttachMutation: hooks.useOrgMemberAttachMutation,
111
+ useMemberRemoveMutation: hooks.useOrgMemberRemoveMutation,
112
+ useMembersQuery: hooks.useOrgMembersQuery,
113
+ useMemberUpdateMutation: hooks.useOrgMemberUpdateMutation,
114
+ useMineQuery: hooks.useOrgMineQuery,
115
+ useReadQuery: hooks.useOrgReadQuery,
116
+ useUpdateMutation: hooks.useOrgUpdateMutation,
117
+ };
118
+ };
@@ -0,0 +1,37 @@
1
+ import {describe, expect, it, mock} from "bun:test";
2
+ import {DateTime} from "luxon";
3
+
4
+ import {ensureSpace, formatDate} from "./pdfUtils";
5
+
6
+ describe("formatDate", () => {
7
+ it("returns an empty string for missing values", () => {
8
+ expect(formatDate(undefined)).toBe("");
9
+ expect(formatDate("")).toBe("");
10
+ expect(formatDate(null)).toBe("");
11
+ });
12
+
13
+ it("returns the raw string when ISO parsing fails", () => {
14
+ expect(formatDate("not-iso")).toBe("not-iso");
15
+ });
16
+
17
+ it("formats a valid ISO timestamp", () => {
18
+ const iso = "2024-06-15T10:30:00Z";
19
+ const expected = DateTime.fromISO(iso).toLocaleString(DateTime.DATETIME_FULL);
20
+ expect(formatDate(iso)).toBe(expected);
21
+ });
22
+ });
23
+
24
+ describe("ensureSpace", () => {
25
+ it("adds a page and resets y when the remaining space is too small", () => {
26
+ const addPage = mock(() => {});
27
+ const nextY = ensureSpace({addPage} as never, 292, 40);
28
+ expect(addPage).toHaveBeenCalled();
29
+ expect(nextY).toBe(20);
30
+ });
31
+
32
+ it("keeps the current y when the content fits", () => {
33
+ const addPage = mock(() => {});
34
+ expect(ensureSpace({addPage} as never, 40, 8)).toBe(40);
35
+ expect(addPage).not.toHaveBeenCalled();
36
+ });
37
+ });
package/src/pdfUtils.ts CHANGED
@@ -5,8 +5,8 @@ export const PAGE_WIDTH = 210;
5
5
  export const MARGIN_LEFT = 20;
6
6
  export const MARGIN_RIGHT = 20;
7
7
  export const CONTENT_WIDTH = PAGE_WIDTH - MARGIN_LEFT - MARGIN_RIGHT;
8
- export const PAGE_HEIGHT = 297;
9
- export const MARGIN_BOTTOM = 20;
8
+ const PAGE_HEIGHT = 297;
9
+ const MARGIN_BOTTOM = 20;
10
10
 
11
11
  export const formatDate = (value: unknown): string => {
12
12
  if (!value) {
@@ -0,0 +1,70 @@
1
+ import {mock} from "bun:test";
2
+
3
+ type HookFactory = (...args: unknown[]) => unknown;
4
+
5
+ const hookOverrides = new Map<string, HookFactory>();
6
+
7
+ const defaultMutation = (): unknown[] => [
8
+ mock(() => ({unwrap: async () => ({})})),
9
+ {isLoading: false},
10
+ ];
11
+
12
+ const defaultHooks: Record<string, HookFactory> = {
13
+ useBulkPatchMutation: defaultMutation,
14
+ useCreateMutation: defaultMutation,
15
+ useDeleteMutation: defaultMutation,
16
+ useListQuery: () => ({
17
+ data: {data: [], total: 0},
18
+ error: null,
19
+ isError: false,
20
+ isLoading: false,
21
+ refetch: mock(() => {}),
22
+ }),
23
+ useReadQuery: (_id?: unknown, opts?: {skip?: boolean}) => {
24
+ if (opts?.skip) {
25
+ return {data: undefined, isLoading: false};
26
+ }
27
+ return {data: undefined, error: null, isLoading: false};
28
+ },
29
+ useUpdateMutation: defaultMutation,
30
+ };
31
+
32
+ export const configureUseAdminApiDouble = (overrides: Record<string, HookFactory>): void => {
33
+ for (const [key, factory] of Object.entries(overrides)) {
34
+ hookOverrides.set(key, factory);
35
+ }
36
+ };
37
+
38
+ export const resetUseAdminApiDouble = (): void => {
39
+ hookOverrides.clear();
40
+ };
41
+
42
+ const resolveHook = (prop: string): HookFactory => {
43
+ const override = hookOverrides.get(prop);
44
+ if (override) {
45
+ return override;
46
+ }
47
+ const defaultHook = defaultHooks[prop];
48
+ if (defaultHook) {
49
+ return defaultHook;
50
+ }
51
+ if (prop.endsWith("Mutation")) {
52
+ return defaultMutation;
53
+ }
54
+ if (prop.endsWith("Query")) {
55
+ return () => ({data: undefined, error: null, isLoading: false});
56
+ }
57
+ return () => undefined;
58
+ };
59
+
60
+ if (process.env.ADMIN_USE_REAL_API !== "1") {
61
+ mock.module("../useAdminApi", () => ({
62
+ useAdminApi: () =>
63
+ new Proxy(
64
+ {},
65
+ {
66
+ get: (_target, prop: string) => resolveHook(prop),
67
+ }
68
+ ),
69
+ }));
70
+ }
package/src/types.ts CHANGED
@@ -66,7 +66,7 @@ export interface AdminFieldConfig {
66
66
  itemRef?: string;
67
67
  }
68
68
 
69
- export interface AdminModelPermissions {
69
+ interface AdminModelPermissions {
70
70
  create?: boolean;
71
71
  delete?: boolean;
72
72
  update?: boolean;
@@ -79,6 +79,19 @@ export interface AdminModelConfig {
79
79
  listFields: string[];
80
80
  defaultSort: string;
81
81
  fields: Record<string, AdminFieldConfig>;
82
+ /**
83
+ * From `GET /admin/config`: true when the app collection registered
84
+ * `sync.adminBroadcast`. Windowed TinyBase lists require this plus
85
+ * {@link AdminProviderValue.syncDb} and a fetch client.
86
+ */
87
+ adminBroadcast?: boolean;
88
+ /**
89
+ * Sync collection tag (`todos`, not `/admin/todos`) when `adminBroadcast`
90
+ * is true. Omitted on other models.
91
+ */
92
+ syncCollection?: string;
93
+ /** True when the admin host enables organizations and the model has `organizationId`. */
94
+ organizationScoped?: boolean;
82
95
  fieldOrder?: string[];
83
96
  /** Optional per-column pixel widths used by AdminModelTable when rendering listFields. */
84
97
  listColumnWidths?: Record<string, number>;
@@ -103,6 +116,7 @@ export interface AdminModelConfig {
103
116
  bulkPatchAllowlist?: string[];
104
117
  fieldsets?: {fields: string[]; title: string}[];
105
118
  filters?: {
119
+ allowEmpty?: boolean;
106
120
  choices?: {label: string; value: string}[];
107
121
  field: string;
108
122
  kind: string;
@@ -123,6 +137,9 @@ export interface AdminModelConfig {
123
137
  export interface AdminCustomScreen {
124
138
  description?: string;
125
139
  displayName: string;
140
+ /** Sidebar group label; grouped screens render with matching model groups in AdminShell. */
141
+ group?: string;
142
+ icon?: string;
126
143
  name: string;
127
144
  }
128
145
 
@@ -132,7 +149,7 @@ export interface AdminScriptConfig {
132
149
  }
133
150
 
134
151
  /** Admin UI v2 home layout slots (Django template-block analogue). */
135
- export interface AdminHomeSlots {
152
+ interface AdminHomeSlots {
136
153
  contentTop?: string[];
137
154
  main?: string[];
138
155
  navGlobal?: string[];
@@ -167,6 +184,8 @@ export interface AdminConfigResponse {
167
184
  };
168
185
  schemaVersion?: number;
169
186
  scripts: AdminScriptConfig[];
187
+ /** Present when AdminApp was given `migrations.dir`. */
188
+ migrations?: {enabled: boolean};
170
189
  /** Plugin home widget ids merged from admin contributions (informational). */
171
190
  widgetIds?: string[];
172
191
  }
@@ -211,20 +230,72 @@ export interface AdminWidgetRegistry {
211
230
  screens: Record<string, ScreenWidgetComponent>;
212
231
  }
213
232
 
233
+ import type {AdminRpc} from "./adminRpc";
234
+
235
+ export type AdminGetAuthHeaders = () => HeadersInit | Promise<HeadersInit>;
236
+
237
+ /** Narrow syncdb surface admin collection CRUD uses. Hosts pass `createSyncDb()` as this. */
238
+ export interface AdminSyncDbEntity {
239
+ data: unknown;
240
+ deleted?: boolean;
241
+ id: string;
242
+ }
243
+
244
+ export interface AdminSyncConflict {
245
+ collection: string;
246
+ entityId: string;
247
+ localData: string;
248
+ mutationId: string;
249
+ serverData: string;
250
+ }
251
+
252
+ export interface AdminSyncConflicts {
253
+ conflicts: AdminSyncConflict[];
254
+ resolve: (args: {mutationId: string; strategy: "useServer" | "keepMine"}) => void;
255
+ }
256
+
257
+ export interface AdminSyncDb {
258
+ hydrateWindow: (args: {
259
+ collection: string;
260
+ ids: string[];
261
+ restRows?: Record<string, unknown>;
262
+ }) => Promise<{hydratedIds: string[]}>;
263
+ mutate: (args: {
264
+ collection: string;
265
+ data?: Record<string, unknown>;
266
+ id?: string;
267
+ operation: "create" | "update" | "delete";
268
+ }) => {id: string; mutationId: string};
269
+ store: {
270
+ getEntity: (args: {collection: string; id: string}) => AdminSyncDbEntity | undefined;
271
+ raw: {
272
+ addTableListener: (tableId: string, listener: () => void) => string;
273
+ delListener: (listenerId: string) => void;
274
+ };
275
+ };
276
+ }
277
+
214
278
  export interface AdminProviderValue {
279
+ adminRpc?: AdminRpc;
215
280
  api: AdminApi;
216
281
  apiBase: string;
282
+ /** API origin for cross-origin embedded RPC (`http://localhost:4000`). */
283
+ apiOrigin?: string;
284
+ credentials?: RequestCredentials;
285
+ getAuthHeaders?: AdminGetAuthHeaders;
217
286
  routeBase: string;
287
+ syncConflicts?: AdminSyncConflicts;
288
+ syncDb?: AdminSyncDb;
218
289
  widgets: AdminWidgetRegistry;
219
290
  }
220
291
 
221
- export interface BackgroundTaskProgress {
292
+ interface BackgroundTaskProgress {
222
293
  percentage: number;
223
294
  stage?: string;
224
295
  message?: string;
225
296
  }
226
297
 
227
- export interface BackgroundTaskLog {
298
+ interface BackgroundTaskLog {
228
299
  timestamp: string;
229
300
  level: "info" | "warn" | "error";
230
301
  message: string;
@@ -280,7 +351,24 @@ export interface AdminScreenProps {
280
351
  apiBase?: string;
281
352
  /** Base path used for in-app navigation. Falls back to `baseUrl`. */
282
353
  routeBase?: string;
354
+ /**
355
+ * @deprecated Terreno 57 compatibility for ObjectId/API-only CRUD. Do not add
356
+ * new admin `injectEndpoints`; Terreno 58 removes the required `api` prop.
357
+ */
283
358
  api: AdminApi;
359
+ /**
360
+ * Fetch credentials mode for {@link adminRequest}. SPA cookie sessions use
361
+ * `"same-origin"`; omit when the host only sends Bearer headers.
362
+ */
363
+ credentials?: RequestCredentials;
364
+ /** Extra headers for {@link adminRequest} (embedded hosts return `Authorization: Bearer …`). */
365
+ getAuthHeaders?: AdminGetAuthHeaders;
366
+ /**
367
+ * Backend origin for native `fetch` RPC when the Expo app and API are on
368
+ * different hosts. Do not put this in `apiBase` — that stays a path prefix
369
+ * (`/admin`) so navigation `routeBase` is not rewritten to the API origin.
370
+ */
371
+ apiOrigin?: string;
284
372
  }
285
373
 
286
374
  /**
@@ -0,0 +1,88 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {buildAdminApiListQueryRequest} from "./adminApiQueryParams";
5
+
6
+ describe("serializeAdminApiQueryParams", () => {
7
+ it("serializes scalar choice filters", () => {
8
+ const serialized = buildAdminApiListQueryRequest("/admin/todos", {
9
+ limit: 25,
10
+ page: 1,
11
+ priority: "high",
12
+ }).url;
13
+ assert.include(serialized, "priority=high");
14
+ assert.include(serialized, "limit=25");
15
+ assert.notInclude(serialized, "object");
16
+ });
17
+
18
+ it("serializes empty-only choice filters with bracketed $in keys", () => {
19
+ const serialized = buildAdminApiListQueryRequest("/admin/todos", {
20
+ limit: 25,
21
+ page: 1,
22
+ priority: {$in: ["__empty__"]},
23
+ }).url;
24
+ assert.include(decodeURIComponent(serialized), "priority[$in][0]=__empty__");
25
+ assert.notInclude(serialized, "object");
26
+ });
27
+
28
+ it("serializes multi-choice $in filters with bracketed keys", () => {
29
+ const serialized = buildAdminApiListQueryRequest("/admin/todos", {
30
+ status: {$in: ["open", "closed"]},
31
+ }).url;
32
+ assert.include(decodeURIComponent(serialized), "status[$in][0]=open");
33
+ assert.include(decodeURIComponent(serialized), "status[$in][1]=closed");
34
+ });
35
+
36
+ it("serializes empty plus concrete choice values in one $in", () => {
37
+ const serialized = buildAdminApiListQueryRequest("/admin/todos", {
38
+ priority: {$in: ["high", "__empty__"]},
39
+ }).url;
40
+ assert.include(decodeURIComponent(serialized), "priority[$in][0]=high");
41
+ assert.include(decodeURIComponent(serialized), "priority[$in][1]=__empty__");
42
+ });
43
+ });
44
+
45
+ describe("buildAdminApiListQueryUrl", () => {
46
+ it("embeds serialized nested params in the URL instead of RTK params", () => {
47
+ const url = buildAdminApiListQueryRequest("/admin/todos", {
48
+ limit: 25,
49
+ page: 1,
50
+ priority: {$in: ["__empty__"]},
51
+ }).url;
52
+ assert.isTrue(url.startsWith("/admin/todos?"));
53
+ assert.include(decodeURIComponent(url), "priority[$in][0]=__empty__");
54
+ assert.notInclude(url, "[object Object]");
55
+ });
56
+ });
57
+
58
+ describe("buildAdminApiListQueryRequest", () => {
59
+ it("leaves the route unchanged when there are no serializable params", () => {
60
+ assert.deepEqual(buildAdminApiListQueryRequest("/admin/todos", undefined), {
61
+ method: "GET",
62
+ url: "/admin/todos",
63
+ });
64
+ assert.deepEqual(buildAdminApiListQueryRequest("/admin/todos", {priority: undefined}), {
65
+ method: "GET",
66
+ url: "/admin/todos",
67
+ });
68
+ });
69
+
70
+ it("returns a GET url with qs-serialized nested filters and no params object", () => {
71
+ const listRequest = buildAdminApiListQueryRequest("/admin/todos", {
72
+ limit: 25,
73
+ page: 1,
74
+ priority: {$in: ["__empty__"]},
75
+ });
76
+
77
+ assert.equal(listRequest.method, "GET");
78
+ assert.include(decodeURIComponent(listRequest.url), "priority[$in][0]=__empty__");
79
+ assert.notInclude(listRequest.url, "[object Object]");
80
+ });
81
+
82
+ it("documents default URLSearchParams coercion that breaks nested operators", () => {
83
+ const broken = new URLSearchParams({
84
+ priority: String({$in: ["__empty__"]}),
85
+ }).toString();
86
+ assert.equal(broken, "priority=%5Bobject+Object%5D");
87
+ });
88
+ });