@terreno/admin-frontend 57.19.2 → 57.21.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 (190) hide show
  1. package/CHANGELOG.md +443 -0
  2. package/dist/AdminFieldRenderer.d.ts +3 -2
  3. package/dist/AdminFieldRenderer.d.ts.map +1 -1
  4. package/dist/AdminFieldRenderer.js +12 -5
  5. package/dist/AdminFieldRenderer.js.map +1 -1
  6. package/dist/AdminFieldRendererCore.d.ts +6 -3
  7. package/dist/AdminFieldRendererCore.d.ts.map +1 -1
  8. package/dist/AdminFieldRendererCore.js +10 -7
  9. package/dist/AdminFieldRendererCore.js.map +1 -1
  10. package/dist/AdminFilterDrawer.d.ts.map +1 -1
  11. package/dist/AdminFilterDrawer.js +2 -3
  12. package/dist/AdminFilterDrawer.js.map +1 -1
  13. package/dist/AdminHome.d.ts.map +1 -1
  14. package/dist/AdminHome.js +5 -2
  15. package/dist/AdminHome.js.map +1 -1
  16. package/dist/AdminModelForm.d.ts.map +1 -1
  17. package/dist/AdminModelForm.js +4 -0
  18. package/dist/AdminModelForm.js.map +1 -1
  19. package/dist/AdminNestedArrayField.d.ts +2 -0
  20. package/dist/AdminNestedArrayField.d.ts.map +1 -1
  21. package/dist/AdminNestedArrayField.js +51 -25
  22. package/dist/AdminNestedArrayField.js.map +1 -1
  23. package/dist/AdminNestedObjectField.d.ts +43 -0
  24. package/dist/AdminNestedObjectField.d.ts.map +1 -0
  25. package/dist/AdminNestedObjectField.js +72 -0
  26. package/dist/AdminNestedObjectField.js.map +1 -0
  27. package/dist/AdminRolesField.d.ts +3 -1
  28. package/dist/AdminRolesField.d.ts.map +1 -1
  29. package/dist/AdminRolesField.js +6 -2
  30. package/dist/AdminRolesField.js.map +1 -1
  31. package/dist/AdminShell.d.ts +3 -3
  32. package/dist/AdminShell.d.ts.map +1 -1
  33. package/dist/AdminShell.js +4 -6
  34. package/dist/AdminShell.js.map +1 -1
  35. package/dist/ConfigurationScreen.d.ts.map +1 -1
  36. package/dist/ConfigurationScreen.js +3 -3
  37. package/dist/ConfigurationScreen.js.map +1 -1
  38. package/dist/ConsentHistory.d.ts.map +1 -1
  39. package/dist/ConsentHistory.js +17 -2
  40. package/dist/ConsentHistory.js.map +1 -1
  41. package/dist/ConsentResponseViewer.d.ts.map +1 -1
  42. package/dist/ConsentResponseViewer.js +20 -2
  43. package/dist/ConsentResponseViewer.js.map +1 -1
  44. package/dist/Constants.d.ts +5 -2
  45. package/dist/Constants.d.ts.map +1 -1
  46. package/dist/Constants.js +5 -2
  47. package/dist/Constants.js.map +1 -1
  48. package/dist/UserSecurityScreen.d.ts +45 -0
  49. package/dist/UserSecurityScreen.d.ts.map +1 -0
  50. package/dist/UserSecurityScreen.js +66 -0
  51. package/dist/UserSecurityScreen.js.map +1 -0
  52. package/dist/consentPdfTemplates.d.ts +64 -0
  53. package/dist/consentPdfTemplates.d.ts.map +1 -0
  54. package/dist/consentPdfTemplates.js +160 -0
  55. package/dist/consentPdfTemplates.js.map +1 -0
  56. package/dist/generateConsentHistoryPdf.d.ts.map +1 -1
  57. package/dist/generateConsentHistoryPdf.js +7 -55
  58. package/dist/generateConsentHistoryPdf.js.map +1 -1
  59. package/dist/generateConsentPdf.d.ts +1 -26
  60. package/dist/generateConsentPdf.d.ts.map +1 -1
  61. package/dist/generateConsentPdf.js +7 -69
  62. package/dist/generateConsentPdf.js.map +1 -1
  63. package/dist/index.d.ts +4 -1
  64. package/dist/index.d.ts.map +1 -1
  65. package/dist/index.js +3 -0
  66. package/dist/index.js.map +1 -1
  67. package/dist/orgs/MemberSecurityPanel.d.ts +34 -0
  68. package/dist/orgs/MemberSecurityPanel.d.ts.map +1 -0
  69. package/dist/orgs/MemberSecurityPanel.js +204 -0
  70. package/dist/orgs/MemberSecurityPanel.js.map +1 -0
  71. package/dist/orgs/OrgMembersScreen.d.ts.map +1 -1
  72. package/dist/orgs/OrgMembersScreen.js +33 -6
  73. package/dist/orgs/OrgMembersScreen.js.map +1 -1
  74. package/dist/orgs/adminModelEndpoints.d.ts +13 -1
  75. package/dist/orgs/adminModelEndpoints.d.ts.map +1 -1
  76. package/dist/orgs/adminModelEndpoints.js +30 -13
  77. package/dist/orgs/adminModelEndpoints.js.map +1 -1
  78. package/dist/orgs/useMemberSecurityApi.d.ts +97 -0
  79. package/dist/orgs/useMemberSecurityApi.d.ts.map +1 -0
  80. package/dist/orgs/useMemberSecurityApi.js +98 -0
  81. package/dist/orgs/useMemberSecurityApi.js.map +1 -0
  82. package/dist/pdfUtils.d.ts +15 -0
  83. package/dist/pdfUtils.d.ts.map +1 -1
  84. package/dist/pdfUtils.js +70 -0
  85. package/dist/pdfUtils.js.map +1 -1
  86. package/dist/types.d.ts +7 -1
  87. package/dist/types.d.ts.map +1 -1
  88. package/dist/types.js.map +1 -1
  89. package/dist/useAdminApi.d.ts +8 -2
  90. package/dist/useAdminApi.d.ts.map +1 -1
  91. package/dist/useAdminApi.js +11 -46
  92. package/dist/useAdminApi.js.map +1 -1
  93. package/dist/useAdminRoles.d.ts +5 -1
  94. package/dist/useAdminRoles.d.ts.map +1 -1
  95. package/dist/useAdminRoles.js +3 -3
  96. package/dist/useAdminRoles.js.map +1 -1
  97. package/dist/useAdminRpc.d.ts.map +1 -1
  98. package/dist/useAdminRpc.js +18 -3
  99. package/dist/useAdminRpc.js.map +1 -1
  100. package/dist/useConsentHistory.d.ts +7 -0
  101. package/dist/useConsentHistory.d.ts.map +1 -1
  102. package/dist/useConsentHistory.js.map +1 -1
  103. package/package.json +7 -3
  104. package/src/AdminBreadcrumbs.test.tsx +1 -1
  105. package/src/AdminFieldRenderer.test.tsx +2 -1
  106. package/src/AdminFieldRenderer.tsx +48 -3
  107. package/src/AdminFieldRendererCore.tsx +12 -5
  108. package/src/AdminFilterDrawer.tsx +3 -4
  109. package/src/AdminHome.test.tsx +65 -1
  110. package/src/AdminHome.tsx +14 -6
  111. package/src/AdminModelForm.tsx +4 -0
  112. package/src/AdminModelTable.test.tsx +16 -12
  113. package/src/AdminModelTable.windowed.test.tsx +11 -5
  114. package/src/AdminNestedArrayField.tsx +116 -44
  115. package/src/AdminNestedObjectField.test.tsx +239 -0
  116. package/src/AdminNestedObjectField.tsx +145 -0
  117. package/src/AdminPrimitiveArrayField.test.tsx +3 -3
  118. package/src/AdminProvider.test.tsx +11 -6
  119. package/src/AdminRolesField.tsx +6 -2
  120. package/src/AdminRolesList.test.tsx +47 -14
  121. package/src/AdminScreenPage.test.tsx +1 -1
  122. package/src/AdminScreenRouter.test.tsx +15 -5
  123. package/src/AdminScriptList.test.tsx +9 -2
  124. package/src/AdminShell.test.tsx +16 -2
  125. package/src/AdminShell.tsx +5 -8
  126. package/src/AdminVersionConfig.test.tsx +4 -4
  127. package/src/AnnouncementOverviewScreenWidget.test.tsx +6 -1
  128. package/src/CheckboxListEditor.test.tsx +11 -9
  129. package/src/ConfigurationScreen.test.tsx +2 -2
  130. package/src/ConfigurationScreen.tsx +6 -2
  131. package/src/ConsentHistory.test.tsx +69 -1
  132. package/src/ConsentHistory.tsx +39 -1
  133. package/src/ConsentResponseViewer.test.tsx +113 -1
  134. package/src/ConsentResponseViewer.tsx +106 -8
  135. package/src/Constants.ts +5 -2
  136. package/src/UserSecurityScreen.tsx +184 -0
  137. package/src/adminRequest.test.ts +3 -3
  138. package/src/adminWindowedTable.test.ts +4 -2
  139. package/src/comms/CommsDashboardScreen.test.tsx +5 -5
  140. package/src/comms/CommsMessageDetail.test.tsx +1 -1
  141. package/src/consentPdfTemplates.test.ts +180 -0
  142. package/src/consentPdfTemplates.ts +228 -0
  143. package/src/generateConsentHistoryPdf.ts +9 -63
  144. package/src/generateConsentPdf.ts +14 -107
  145. package/src/index.tsx +20 -0
  146. package/src/isolated/AdminFieldRenderer.isolated.tsx +11 -6
  147. package/src/isolated/AdminFilterDrawer.isolated.tsx +8 -6
  148. package/src/isolated/AdminFilterDrawerMobile.isolated.tsx +3 -1
  149. package/src/isolated/AdminHomeWidgets.isolated.tsx +2 -0
  150. package/src/isolated/AdminNestedArrayField.isolated.tsx +103 -10
  151. package/src/isolated/AdminObjectPicker.isolated.tsx +9 -10
  152. package/src/isolated/AiPromptsListScreen.isolated.tsx +1 -1
  153. package/src/isolated/DocumentStorageBrowser.isolated.tsx +16 -8
  154. package/src/isolated/RecentActivityWidget.isolated.tsx +2 -0
  155. package/src/isolated/UserSecurityScreen.isolated.tsx +365 -0
  156. package/src/isolated/adminWidgets.isolated.tsx +46 -6
  157. package/src/isolated/aiObservabilityScreens.isolated.tsx +18 -9
  158. package/src/isolated/generateConsentHistoryPdf.isolated.ts +60 -7
  159. package/src/isolated/generateConsentPdf.isolated.ts +47 -0
  160. package/src/isolated/generateConsentPdfMobile.isolated.ts +28 -0
  161. package/src/isolated/generateConsentPdfsMobile.isolated.ts +59 -2
  162. package/src/isolated/hooks.isolated.tsx +163 -42
  163. package/src/isolated/rpcDualRun.isolated.tsx +9 -2
  164. package/src/jobs/JobsDashboardScreen.test.tsx +3 -3
  165. package/src/jobs/JobsHomeWidget.test.tsx +1 -1
  166. package/src/jobs/JobsJobDetail.test.tsx +1 -1
  167. package/src/orgs/MemberSecurityPanel.test.tsx +584 -0
  168. package/src/orgs/MemberSecurityPanel.tsx +520 -0
  169. package/src/orgs/OrgManagementScreens.test.tsx +121 -2
  170. package/src/orgs/OrgMembersScreen.tsx +71 -4
  171. package/src/orgs/adminModelEndpoints.test.ts +1 -1
  172. package/src/orgs/adminModelEndpoints.ts +56 -15
  173. package/src/orgs/useMemberSecurityApi.ts +198 -0
  174. package/src/pdfUtils.test.ts +24 -1
  175. package/src/pdfUtils.ts +93 -0
  176. package/src/testing/useAdminApiDouble.ts +2 -1
  177. package/src/types.ts +7 -1
  178. package/src/useAdminApi.ts +23 -3
  179. package/src/useAdminRoles.ts +11 -3
  180. package/src/useAdminRpc.test.tsx +116 -2
  181. package/src/useAdminRpc.ts +19 -3
  182. package/src/useConsentHistory.ts +5 -0
  183. package/src/widgets/AIRequestsScreenWidget.test.tsx +20 -3
  184. package/src/widgets/ModelsGridWidget.test.tsx +25 -5
  185. package/src/widgets/aiObservability/datasets/AiDatasetDetailView.test.tsx +4 -2
  186. package/src/widgets/aiObservability/datasets/datasetTypes.test.ts +0 -1
  187. package/src/widgets/aiObservability/evaluators/AiEvaluatorPanels.test.tsx +89 -23
  188. package/src/widgets/aiObservability/experiments/AiExperimentNewView.test.tsx +4 -0
  189. package/src/widgets/aiObservability/shell/ObservabilityTable.test.tsx +7 -1
  190. package/src/widgets/builtInFieldWidgets.test.tsx +16 -3
@@ -0,0 +1,239 @@
1
+ import {describe, expect, it, mock} from "bun:test";
2
+ import {fireEvent} from "@testing-library/react-native";
3
+ import React from "react";
4
+ import {renderWithTheme} from "../../ui/src/test-utils";
5
+ import {AdminFieldRenderer} from "./AdminFieldRenderer";
6
+ import {buildNestedObjectDefault, isNestedObjectField} from "./AdminNestedObjectField";
7
+ import type {AdminApi, AdminFieldConfig, AdminFieldValue} from "./types";
8
+
9
+ const api = {} as unknown as AdminApi;
10
+
11
+ const TASKS_CONFIG: AdminFieldConfig = {
12
+ description: "Project task settings",
13
+ items: {
14
+ enabled: {
15
+ default: false,
16
+ description: "Turn on project tasks",
17
+ required: false,
18
+ type: "boolean",
19
+ },
20
+ intakePollMs: {
21
+ default: 300000,
22
+ description: "How often intake polls, in ms",
23
+ required: false,
24
+ type: "number",
25
+ },
26
+ labels: {itemType: "string", required: false, type: "array"},
27
+ },
28
+ required: false,
29
+ type: "object",
30
+ };
31
+
32
+ const MCP_MEDIA_CONFIG: AdminFieldConfig = {
33
+ items: {
34
+ port: {required: false, type: "number"},
35
+ sonarr: {
36
+ items: {
37
+ apiKey: {required: false, type: "string"},
38
+ url: {required: false, type: "string"},
39
+ },
40
+ required: false,
41
+ type: "object",
42
+ },
43
+ },
44
+ required: false,
45
+ type: "object",
46
+ };
47
+
48
+ describe("AdminNestedObjectField via AdminFieldRenderer", () => {
49
+ it("renders each leaf with its own control instead of a JSON box", () => {
50
+ const {getByTestId, getByText, queryByText} = renderWithTheme(
51
+ <AdminFieldRenderer
52
+ api={api}
53
+ fieldConfig={TASKS_CONFIG}
54
+ fieldKey="tasks"
55
+ onChange={() => {}}
56
+ value={{enabled: true, intakePollMs: 1000, labels: ["a"]}}
57
+ />
58
+ );
59
+ expect(getByTestId("admin-field-group-tasks")).toBeTruthy();
60
+ expect(getByText("Tasks")).toBeTruthy();
61
+ expect(getByText("Project task settings")).toBeTruthy();
62
+ expect(getByTestId("admin-field-tasks.enabled")).toBeTruthy();
63
+ expect(getByTestId("admin-field-tasks.intakePollMs").props.value).toBe("1000");
64
+ expect(getByText("Enabled")).toBeTruthy();
65
+ expect(getByText("Intake Poll Ms")).toBeTruthy();
66
+ expect(getByText("How often intake polls, in ms")).toBeTruthy();
67
+ expect(getByText("Labels")).toBeTruthy();
68
+ expect(queryByText("JSON value (string, number, boolean, object, or array)")).toBeNull();
69
+ });
70
+
71
+ it("shows subfield defaults when the stored object is missing a leaf", () => {
72
+ const {getByTestId} = renderWithTheme(
73
+ <AdminFieldRenderer
74
+ api={api}
75
+ fieldConfig={TASKS_CONFIG}
76
+ fieldKey="tasks"
77
+ onChange={() => {}}
78
+ value={{enabled: true}}
79
+ />
80
+ );
81
+ expect(getByTestId("admin-field-tasks.intakePollMs").props.value).toBe("300000");
82
+ });
83
+
84
+ it("merges an edited leaf into the parent object", () => {
85
+ const onChange = mock((_: AdminFieldValue) => {});
86
+ const {getByTestId} = renderWithTheme(
87
+ <AdminFieldRenderer
88
+ api={api}
89
+ fieldConfig={TASKS_CONFIG}
90
+ fieldKey="tasks"
91
+ onChange={onChange}
92
+ value={{enabled: true, intakePollMs: 1000}}
93
+ />
94
+ );
95
+ fireEvent.changeText(getByTestId("admin-field-tasks.intakePollMs"), "2500");
96
+ expect(onChange).toHaveBeenCalledWith({enabled: true, intakePollMs: 2500});
97
+ });
98
+
99
+ it("recurses into deeper nested objects", () => {
100
+ const onChange = mock((_: AdminFieldValue) => {});
101
+ const {getByTestId} = renderWithTheme(
102
+ <AdminFieldRenderer
103
+ api={api}
104
+ fieldConfig={MCP_MEDIA_CONFIG}
105
+ fieldKey="mcpMedia"
106
+ onChange={onChange}
107
+ value={{port: 8080, sonarr: {apiKey: "k", url: "http://old"}}}
108
+ />
109
+ );
110
+ expect(getByTestId("admin-field-group-mcpMedia.sonarr")).toBeTruthy();
111
+ fireEvent.changeText(getByTestId("admin-field-mcpMedia.sonarr.url"), "http://new");
112
+ expect(onChange).toHaveBeenCalledWith({
113
+ port: 8080,
114
+ sonarr: {apiKey: "k", url: "http://new"},
115
+ });
116
+ });
117
+
118
+ it("renders a nested object with no stored value", () => {
119
+ const onChange = mock((_: AdminFieldValue) => {});
120
+ const {getByTestId} = renderWithTheme(
121
+ <AdminFieldRenderer
122
+ api={api}
123
+ fieldConfig={MCP_MEDIA_CONFIG}
124
+ fieldKey="mcpMedia"
125
+ onChange={onChange}
126
+ value={undefined}
127
+ />
128
+ );
129
+ fireEvent.changeText(getByTestId("admin-field-mcpMedia.port"), "9000");
130
+ expect(onChange).toHaveBeenCalledWith({port: 9000});
131
+ });
132
+
133
+ it("groups nested objects inside array-of-subdocument items", () => {
134
+ const {getByTestId, queryByText} = renderWithTheme(
135
+ <AdminFieldRenderer
136
+ api={api}
137
+ fieldConfig={{items: {media: MCP_MEDIA_CONFIG}, required: false, type: "array"}}
138
+ fieldKey="servers"
139
+ onChange={() => {}}
140
+ readOnly
141
+ value={[
142
+ {media: {port: 1, sonarr: {apiKey: "k", url: "http://x"}}},
143
+ {media: {port: 2, sonarr: {apiKey: "j", url: "http://y"}}},
144
+ ]}
145
+ />
146
+ );
147
+ expect(getByTestId("admin-field-group-servers.0.media")).toBeTruthy();
148
+ expect(getByTestId("admin-field-servers.0.media.sonarr.url").props.value).toBe("http://x");
149
+ expect(getByTestId("admin-field-servers.1.media.sonarr.url").props.value).toBe("http://y");
150
+ expect(queryByText("JSON value (string, number, boolean, object, or array)")).toBeNull();
151
+ });
152
+
153
+ it("keeps a string leaf a text field when only its parent's name contains 'date'", () => {
154
+ const onChange = mock((_: AdminFieldValue) => {});
155
+ const {getByTestId} = renderWithTheme(
156
+ <AdminFieldRenderer
157
+ api={api}
158
+ fieldConfig={{
159
+ items: {note: {required: false, type: "string"}},
160
+ required: false,
161
+ type: "object",
162
+ }}
163
+ fieldKey="updates"
164
+ onChange={onChange}
165
+ value={{note: "hello"}}
166
+ />
167
+ );
168
+ const noteInput = getByTestId("admin-field-updates.note");
169
+ expect(noteInput.props.value).toBe("hello");
170
+ fireEvent.changeText(noteInput, "bye");
171
+ expect(onChange).toHaveBeenCalledWith({note: "bye"});
172
+ });
173
+
174
+ it("keeps the JSON editor for objects without subfields and for mixed", () => {
175
+ const {getAllByText} = renderWithTheme(
176
+ <>
177
+ <AdminFieldRenderer
178
+ api={api}
179
+ fieldConfig={{required: false, type: "object"}}
180
+ fieldKey="selectors"
181
+ onChange={() => {}}
182
+ value={{a: 1}}
183
+ />
184
+ <AdminFieldRenderer
185
+ api={api}
186
+ fieldConfig={{items: {}, required: false, type: "object"}}
187
+ fieldKey="emptyItems"
188
+ onChange={() => {}}
189
+ value={{}}
190
+ />
191
+ <AdminFieldRenderer
192
+ api={api}
193
+ fieldConfig={{required: false, type: "mixed"}}
194
+ fieldKey="data"
195
+ onChange={() => {}}
196
+ value={{b: 2}}
197
+ />
198
+ </>
199
+ );
200
+ expect(getAllByText("JSON value (string, number, boolean, object, or array)")).toHaveLength(3);
201
+ });
202
+ });
203
+
204
+ describe("isNestedObjectField", () => {
205
+ it("is true only for objects with subfields and no custom widget", () => {
206
+ expect(isNestedObjectField(TASKS_CONFIG)).toBe(true);
207
+ expect(isNestedObjectField({required: false, type: "object"})).toBe(false);
208
+ expect(isNestedObjectField({...TASKS_CONFIG, widget: "locale-content"})).toBe(false);
209
+ expect(isNestedObjectField({...TASKS_CONFIG, type: "mixed"})).toBe(false);
210
+ expect(isNestedObjectField({...TASKS_CONFIG, type: "array"})).toBe(false);
211
+ });
212
+ });
213
+
214
+ describe("buildNestedObjectDefault", () => {
215
+ it("uses schema defaults and blank values, recursing into nested objects", () => {
216
+ expect(buildNestedObjectDefault(TASKS_CONFIG.items ?? {})).toEqual({
217
+ enabled: false,
218
+ intakePollMs: 300000,
219
+ labels: [],
220
+ });
221
+ expect(buildNestedObjectDefault(MCP_MEDIA_CONFIG.items ?? {})).toEqual({
222
+ port: 0,
223
+ sonarr: {apiKey: "", url: ""},
224
+ });
225
+ });
226
+
227
+ it("omits enums, refs, dates, mixed, and system fields without a default", () => {
228
+ expect(
229
+ buildNestedObjectDefault({
230
+ _id: {required: false, type: "objectid"},
231
+ kind: {enum: ["a", "b"], required: false, type: "string"},
232
+ name: {required: false, type: "string"},
233
+ owner: {ref: "User", required: false, type: "string"},
234
+ payload: {required: false, type: "mixed"},
235
+ when: {required: false, type: "date"},
236
+ })
237
+ ).toEqual({name: ""});
238
+ });
239
+ });
@@ -0,0 +1,145 @@
1
+ import {Box, Heading, Text} from "@terreno/ui";
2
+ import startCase from "lodash/startCase";
3
+ import React, {useCallback, useMemo} from "react";
4
+ import type {AdminFieldConfig, AdminFieldValue} from "./types";
5
+ import {SYSTEM_FIELDS} from "./types";
6
+
7
+ export interface AdminNestedObjectSubFieldArgs {
8
+ /** Dotted path of the subfield, e.g. `tasks.enabled`. */
9
+ fieldKey: string;
10
+ /** Humanized label of the subfield's own key. */
11
+ label: string;
12
+ fieldConfig: AdminFieldConfig;
13
+ value: AdminFieldValue;
14
+ onChange: (value: AdminFieldValue) => void;
15
+ readOnly?: boolean;
16
+ }
17
+
18
+ interface AdminNestedObjectFieldProps {
19
+ /** Dotted path of the object field, used as the prefix for subfield keys and test IDs. */
20
+ fieldKey: string;
21
+ title: string;
22
+ helperText?: string;
23
+ errorText?: string;
24
+ fields: Record<string, AdminFieldConfig>;
25
+ value: AdminFieldValue;
26
+ onChange: (value: Record<string, AdminFieldValue>) => void;
27
+ readOnly?: boolean;
28
+ /**
29
+ * Renders one subfield. Passed in by the caller so subfields can use the full renderer
30
+ * (including nested arrays and deeper objects) without a require cycle.
31
+ */
32
+ renderSubField: (args: AdminNestedObjectSubFieldArgs) => React.ReactElement;
33
+ }
34
+
35
+ /** Whether a field config describes a nested object whose subfields can be rendered as a group. */
36
+ export const isNestedObjectField = (fieldConfig: AdminFieldConfig): boolean => {
37
+ return (
38
+ fieldConfig.type === "object" &&
39
+ !fieldConfig.widget &&
40
+ fieldConfig.items != null &&
41
+ Object.keys(fieldConfig.items).length > 0
42
+ );
43
+ };
44
+
45
+ /**
46
+ * Initial value for a nested object in a create form: each subfield's schema default, or the
47
+ * same blank value a top-level field of that type starts with. Enums, refs, dates, and Mixed
48
+ * subfields without a default are left out so a blank value never fails a cast or enum check.
49
+ */
50
+ export const buildNestedObjectDefault = (
51
+ fields: Record<string, AdminFieldConfig>
52
+ ): Record<string, AdminFieldValue> => {
53
+ const result: Record<string, AdminFieldValue> = {};
54
+ for (const [key, config] of Object.entries(fields)) {
55
+ if (SYSTEM_FIELDS.has(key)) {
56
+ continue;
57
+ }
58
+ if (config.default !== undefined) {
59
+ result[key] = config.default;
60
+ } else if (isNestedObjectField(config) && config.items) {
61
+ result[key] = buildNestedObjectDefault(config.items);
62
+ } else if (config.type === "boolean") {
63
+ result[key] = false;
64
+ } else if (config.type === "number") {
65
+ result[key] = 0;
66
+ } else if (config.type === "array") {
67
+ result[key] = [];
68
+ } else if (config.type === "string" && !config.ref && !config.enum?.length) {
69
+ result[key] = "";
70
+ }
71
+ }
72
+ return result;
73
+ };
74
+
75
+ const toObjectValue = (value: AdminFieldValue): Record<string, AdminFieldValue> => {
76
+ if (value && typeof value === "object" && !Array.isArray(value)) {
77
+ return value as Record<string, AdminFieldValue>;
78
+ }
79
+ return {};
80
+ };
81
+
82
+ /**
83
+ * Renders a nested (non-array) object path as a titled group of its subfields, each with its
84
+ * type-appropriate control. Editing a subfield writes the merged object back to the parent.
85
+ */
86
+ export const AdminNestedObjectField: React.FC<AdminNestedObjectFieldProps> = ({
87
+ fieldKey,
88
+ title,
89
+ helperText,
90
+ errorText,
91
+ fields,
92
+ value,
93
+ onChange,
94
+ readOnly,
95
+ renderSubField,
96
+ }) => {
97
+ const objectValue = useMemo((): Record<string, AdminFieldValue> => toObjectValue(value), [value]);
98
+
99
+ const subFieldEntries = useMemo((): [string, AdminFieldConfig][] => {
100
+ return Object.entries(fields).filter(([key]) => !SYSTEM_FIELDS.has(key));
101
+ }, [fields]);
102
+
103
+ const handleSubFieldChange = useCallback(
104
+ (subKey: string, subValue: AdminFieldValue): void => {
105
+ onChange({...objectValue, [subKey]: subValue});
106
+ },
107
+ [objectValue, onChange]
108
+ );
109
+
110
+ return (
111
+ <Box
112
+ border="default"
113
+ gap={3}
114
+ padding={3}
115
+ rounding="md"
116
+ testID={`admin-field-group-${fieldKey}`}
117
+ >
118
+ <Box gap={1}>
119
+ <Heading size="sm">{title}</Heading>
120
+ {helperText ? (
121
+ <Text color="secondaryDark" size="sm">
122
+ {helperText}
123
+ </Text>
124
+ ) : null}
125
+ {errorText ? (
126
+ <Text color="error" size="sm">
127
+ {errorText}
128
+ </Text>
129
+ ) : null}
130
+ </Box>
131
+ {subFieldEntries.map(([subKey, subConfig]) => (
132
+ <React.Fragment key={subKey}>
133
+ {renderSubField({
134
+ fieldConfig: subConfig,
135
+ fieldKey: `${fieldKey}.${subKey}`,
136
+ label: startCase(subKey),
137
+ onChange: (subValue: AdminFieldValue) => handleSubFieldChange(subKey, subValue),
138
+ readOnly,
139
+ value: objectValue[subKey] ?? subConfig.default,
140
+ })}
141
+ </React.Fragment>
142
+ ))}
143
+ </Box>
144
+ );
145
+ };
@@ -7,7 +7,7 @@ import {Pressable} from "react-native";
7
7
  import type {ReactTestInstance} from "react-test-renderer";
8
8
  import {renderWithTheme} from "../../ui/src/test-utils";
9
9
  import {AdminPrimitiveArrayField} from "./AdminPrimitiveArrayField";
10
- import type {AdminApi} from "./types";
10
+ import type {AdminApi, RefFieldRendererProps} from "./types";
11
11
 
12
12
  const press = async (el: ReactTestInstance): Promise<void> => {
13
13
  await act(async () => {
@@ -342,7 +342,7 @@ describe("AdminPrimitiveArrayField", () => {
342
342
  });
343
343
 
344
344
  it("uses custom reference renderers with resolved routes", () => {
345
- const CustomRenderer: React.FC<Record<string, unknown>> = (props) =>
345
+ const CustomRenderer: React.FC<RefFieldRendererProps> = (props) =>
346
346
  React.createElement("CustomRenderer", props);
347
347
  const {UNSAFE_root} = renderWithTheme(
348
348
  <AdminPrimitiveArrayField
@@ -360,7 +360,7 @@ describe("AdminPrimitiveArrayField", () => {
360
360
  value={["user-1"]}
361
361
  />
362
362
  );
363
- const custom = UNSAFE_root.findAll((node) => node.type === "CustomRenderer")[0];
363
+ const custom = UNSAFE_root.findAll((node) => String(node.type) === "CustomRenderer")[0];
364
364
  expect(custom.props.routePath).toBe("/admin/users");
365
365
  expect(custom.props.autocomplete).toBe(true);
366
366
  expect(custom.props.readOnly).toBe(true);
@@ -46,8 +46,9 @@ describe("AdminProvider widget registry", () => {
46
46
  const CustomHome: HomeWidgetComponent = () => null;
47
47
  const CustomField: FieldWidgetComponent = () => null;
48
48
  const CustomScreen: ScreenWidgetComponent = () => null;
49
- let context: AdminProviderValue | null = null;
50
- let registry: AdminWidgetRegistry | null = null;
49
+ // Assigned inside the probe render, so the declared type must not narrow to null.
50
+ let context = null as AdminProviderValue | null;
51
+ let registry = null as AdminWidgetRegistry | null;
51
52
  const Probe: React.FC = () => {
52
53
  context = useAdminContext();
53
54
  registry = useAdminWidgetRegistry();
@@ -146,7 +147,8 @@ describe("AdminProvider widget registry", () => {
146
147
 
147
148
  it("exposes host-injected credentials and getAuthHeaders on context", () => {
148
149
  const getAuthHeaders = (): HeadersInit => ({Authorization: "Bearer ctx-token"});
149
- let context: AdminProviderValue | null = null;
150
+ // Assigned inside the probe render, so the declared type must not narrow to null.
151
+ let context = null as AdminProviderValue | null;
150
152
  const Probe: React.FC = () => {
151
153
  context = useAdminContext();
152
154
  return null;
@@ -170,7 +172,8 @@ describe("AdminProvider widget registry", () => {
170
172
  });
171
173
 
172
174
  it("exposes apiOrigin and binds it onto RPC context", () => {
173
- let context: AdminProviderValue | null = null;
175
+ // Assigned inside the probe render, so the declared type must not narrow to null.
176
+ let context = null as AdminProviderValue | null;
174
177
  const Probe: React.FC = () => {
175
178
  context = useAdminContext();
176
179
  return null;
@@ -201,7 +204,8 @@ describe("AdminProvider widget registry", () => {
201
204
  raw: {addTableListener: () => "listener", delListener: () => {}},
202
205
  },
203
206
  };
204
- let context: AdminProviderValue | null = null;
207
+ // Assigned inside the probe render, so the declared type must not narrow to null.
208
+ let context = null as AdminProviderValue | null;
205
209
  const Probe: React.FC = () => {
206
210
  context = useAdminContext();
207
211
  return null;
@@ -218,7 +222,8 @@ describe("AdminProvider widget registry", () => {
218
222
 
219
223
  it("exposes the host useConflicts adapter on context", () => {
220
224
  const syncConflicts = {conflicts: [], resolve: () => {}};
221
- let context: AdminProviderValue | null = null;
225
+ // Assigned inside the probe render, so the declared type must not narrow to null.
226
+ let context = null as AdminProviderValue | null;
222
227
  const Probe: React.FC = () => {
223
228
  context = useAdminContext();
224
229
  return null;
@@ -15,7 +15,9 @@ const roleNamesFromValue = (value: unknown): string[] => {
15
15
  * User-role editor backed by the RBAC role collection.
16
16
  *
17
17
  * Existing assignments remain visible and removable while the select only offers roles that
18
- * are not already assigned.
18
+ * are not already assigned. A read-only field lists the assigned role names without loading the
19
+ * role catalog, so staff who may view a user but not read RBAC roles (such as an operator) see
20
+ * the record without a refused `/rbac/roles` request.
19
21
  */
20
22
  export const AdminRolesField: React.FC<AdminFieldWidgetProps> = ({
21
23
  api,
@@ -29,7 +31,9 @@ export const AdminRolesField: React.FC<AdminFieldWidgetProps> = ({
29
31
  }) => {
30
32
  const {apiBase: resolvedApiBase} = resolveAdminBases({apiBase, baseUrl});
31
33
  const {useListRolesQuery} = useAdminRoles(api, resolvedApiBase);
32
- const {data, error, isLoading} = useListRolesQuery();
34
+ // The catalog only supplies display names and the options to add; a read-only field needs
35
+ // neither, and its viewer may lack `rbac:read`.
36
+ const {data, error, isLoading} = useListRolesQuery(undefined, {skip: Boolean(readOnly)});
33
37
  const roles = normalizeRoles(data);
34
38
  const selectedRoleNames = roleNamesFromValue(value);
35
39
  const selectedRoleSet = useMemo(() => new Set(selectedRoleNames), [selectedRoleNames]);
@@ -9,25 +9,38 @@ import {renderWithTheme} from "../../ui/src/test-utils";
9
9
  import {AdminRolesField} from "./AdminRolesField";
10
10
  import {AdminRolesList} from "./AdminRolesList";
11
11
  import type {AdminApi} from "./types";
12
- import {normalizeRoles, normalizeStatements, type RolesQueryResult} from "./useAdminRoles";
12
+ import {
13
+ normalizeRoles,
14
+ normalizeStatements,
15
+ type RolesQueryResult,
16
+ type useAdminRoles,
17
+ } from "./useAdminRoles";
18
+
19
+ type StatementsQueryResult = ReturnType<ReturnType<typeof useAdminRoles>["useListStatementsQuery"]>;
13
20
 
14
21
  const mockUseListRolesQuery = mock(
15
- (): RolesQueryResult => ({data: undefined, error: null, isLoading: false})
22
+ (_arg?: undefined, _options?: {skip?: boolean}): RolesQueryResult => ({
23
+ data: undefined,
24
+ error: null,
25
+ isLoading: false,
26
+ })
16
27
  );
17
28
  const mockRefetch = mock(() => {});
18
- const mockCreateRole = mock(() => ({unwrap: async () => ({})}));
19
- const mockUpdateRole = mock(() => ({unwrap: async () => ({})}));
20
- const mockUseListStatementsQuery = mock(() => ({
21
- data: {
22
- statements: {
23
- admin: ["access", "runScripts"],
24
- adminTodo: ["read", "write", "writeOwned"],
25
- todo: ["read", "update"],
29
+ const mockCreateRole = mock((_arg: unknown) => ({unwrap: async () => ({})}));
30
+ const mockUpdateRole = mock((_arg: unknown) => ({unwrap: async () => ({})}));
31
+ const mockUseListStatementsQuery = mock(
32
+ (): StatementsQueryResult => ({
33
+ data: {
34
+ statements: {
35
+ admin: ["access", "runScripts"],
36
+ adminTodo: ["read", "write", "writeOwned"],
37
+ todo: ["read", "update"],
38
+ },
26
39
  },
27
- },
28
- error: null,
29
- isLoading: false,
30
- }));
40
+ error: null,
41
+ isLoading: false,
42
+ })
43
+ );
31
44
 
32
45
  mock.module("./useAdminRoles", () => ({
33
46
  normalizeRoles,
@@ -573,6 +586,26 @@ describe("AdminRolesField", () => {
573
586
  expect(onChange).toHaveBeenCalledWith(["member", "manager"]);
574
587
  });
575
588
 
589
+ it("does not load the role catalog for a read-only field", () => {
590
+ mockUseListRolesQuery.mockClear();
591
+ const {getByTestId, queryByTestId} = renderWithTheme(
592
+ <AdminRolesField
593
+ api={mockApi}
594
+ apiBase="/admin"
595
+ fieldConfig={fieldConfig}
596
+ fieldKey="roles"
597
+ onChange={mock(() => undefined)}
598
+ readOnly
599
+ value={["member"]}
600
+ />
601
+ );
602
+
603
+ expect(mockUseListRolesQuery.mock.calls.at(-1)).toEqual([undefined, {skip: true}]);
604
+ expect(getByTestId("admin-field-roles-selected-member")).toBeTruthy();
605
+ expect(queryByTestId("admin-field-roles-add")).toBeNull();
606
+ expect(queryByTestId("admin-field-roles-load-error")).toBeNull();
607
+ });
608
+
576
609
  it("removes an assigned role without changing other assignments", async () => {
577
610
  const onChange = mock((_value: unknown) => undefined);
578
611
  const {getByTestId} = renderWithTheme(
@@ -6,7 +6,7 @@ import React from "react";
6
6
  import {renderWithTheme} from "../../ui/src/test-utils";
7
7
  import {AdminScreenPage} from "./AdminScreenPage";
8
8
 
9
- const pushMock = mock(() => {});
9
+ const pushMock = mock((_href: unknown) => {});
10
10
  const backMock = mock(() => {});
11
11
 
12
12
  mock.module("expo-router", () => ({
@@ -214,6 +214,10 @@ const mockTask: {data: {task?: BackgroundTask} | undefined; error: unknown} = {
214
214
  error: null,
215
215
  };
216
216
 
217
+ // The view reads only a task's status.
218
+ const taskWithStatus = (status: BackgroundTask["status"]): BackgroundTask =>
219
+ ({status}) as BackgroundTask;
220
+
217
221
  const createApiDouble = (): AdminApi => {
218
222
  const api = {
219
223
  enhanceEndpoints: () => api,
@@ -314,9 +318,15 @@ describe("AdminMigrationsView", () => {
314
318
  config: {
315
319
  migrations: {enabled: true},
316
320
  models: [],
317
- platformTools: {runScripts: false},
321
+ platformTools: {
322
+ configuration: true,
323
+ roles: true,
324
+ runScripts: false,
325
+ scripts: true,
326
+ version: true,
327
+ },
318
328
  scripts: [],
319
- } as AdminConfigResponse,
329
+ },
320
330
  });
321
331
  expect(getByTestId("admin-migrations-dry-run").props.accessibilityState.disabled).toBe(true);
322
332
  expect(getByTestId("admin-migrations-apply").props.accessibilityState.disabled).toBe(true);
@@ -408,7 +418,7 @@ describe("AdminMigrationsView", () => {
408
418
  });
409
419
 
410
420
  it("disables apply while a queued task is in flight", async () => {
411
- mockTask.data = {task: {status: "queued"}};
421
+ mockTask.data = {task: taskWithStatus("pending")};
412
422
  const {getByTestId, getByText} = renderView();
413
423
  await act(async () => {
414
424
  fireEvent.press(getByText("Dry run"));
@@ -418,7 +428,7 @@ describe("AdminMigrationsView", () => {
418
428
  });
419
429
 
420
430
  it("refetches status after a completed task", async () => {
421
- mockTask.data = {task: {status: "completed"}};
431
+ mockTask.data = {task: taskWithStatus("completed")};
422
432
  const {getByText} = renderView();
423
433
  await act(async () => {
424
434
  fireEvent.press(getByText("Dry run"));
@@ -427,7 +437,7 @@ describe("AdminMigrationsView", () => {
427
437
  });
428
438
 
429
439
  it("keeps apply disabled while a task is running", async () => {
430
- mockTask.data = {task: {status: "running"}};
440
+ mockTask.data = {task: taskWithStatus("running")};
431
441
  const {getByTestId, getByText} = renderView();
432
442
  await act(async () => {
433
443
  fireEvent.press(getByText("Dry run"));
@@ -9,7 +9,7 @@ import {adminScriptsHarness} from "./adminScriptsHarness.test";
9
9
  import type {AdminApi, AdminConfigResponse} from "./types";
10
10
 
11
11
  // Mock useAdminConfig to control returned data
12
- const mockUseAdminConfig = mock(() => ({
12
+ const mockUseAdminConfig = mock((..._args: unknown[]) => ({
13
13
  config: null as AdminConfigResponse | null,
14
14
  error: null as Error | null,
15
15
  isLoading: false,
@@ -342,7 +342,14 @@ describe("AdminScriptList", () => {
342
342
  mockUseAdminConfig.mockReturnValue({
343
343
  config: {
344
344
  models: [],
345
- platformTools: {runScripts: false, viewScripts: false},
345
+ platformTools: {
346
+ configuration: true,
347
+ roles: true,
348
+ runScripts: false,
349
+ scripts: true,
350
+ version: true,
351
+ viewScripts: false,
352
+ },
346
353
  scripts: [{description: "Test script", name: "test-script"}],
347
354
  },
348
355
  error: null,