@terreno/admin-frontend 57.0.0 → 57.2.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 (158) hide show
  1. package/dist/AdminActionMenu.d.ts +15 -0
  2. package/dist/AdminActionMenu.js +56 -0
  3. package/dist/AdminActionMenu.js.map +1 -0
  4. package/dist/AdminFieldRenderer.js +2 -2
  5. package/dist/AdminFieldRenderer.js.map +1 -1
  6. package/dist/AdminFieldRendererCore.d.ts +2 -0
  7. package/dist/AdminFieldRendererCore.js +18 -47
  8. package/dist/AdminFieldRendererCore.js.map +1 -1
  9. package/dist/AdminFilterDrawer.d.ts +20 -0
  10. package/dist/AdminFilterDrawer.js +117 -0
  11. package/dist/AdminFilterDrawer.js.map +1 -0
  12. package/dist/AdminHome.d.ts +2 -4
  13. package/dist/AdminHome.js +15 -137
  14. package/dist/AdminHome.js.map +1 -1
  15. package/dist/AdminModelForm.js +29 -10
  16. package/dist/AdminModelForm.js.map +1 -1
  17. package/dist/AdminModelList.d.ts +2 -1
  18. package/dist/AdminModelList.js +5 -1
  19. package/dist/AdminModelList.js.map +1 -1
  20. package/dist/AdminModelTable.js +56 -98
  21. package/dist/AdminModelTable.js.map +1 -1
  22. package/dist/AdminObjectPicker.d.ts +3 -0
  23. package/dist/AdminObjectPicker.js +27 -7
  24. package/dist/AdminObjectPicker.js.map +1 -1
  25. package/dist/AdminPrimitiveArrayField.d.ts +2 -0
  26. package/dist/AdminPrimitiveArrayField.js +3 -3
  27. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  28. package/dist/AdminProvider.d.ts +16 -0
  29. package/dist/AdminProvider.js +84 -0
  30. package/dist/AdminProvider.js.map +1 -0
  31. package/dist/AdminRefField.js +2 -2
  32. package/dist/AdminRefField.js.map +1 -1
  33. package/dist/AdminRolesField.d.ts +9 -0
  34. package/dist/AdminRolesField.js +45 -0
  35. package/dist/AdminRolesField.js.map +1 -0
  36. package/dist/AdminRolesList.d.ts +3 -0
  37. package/dist/AdminRolesList.js +187 -0
  38. package/dist/AdminRolesList.js.map +1 -0
  39. package/dist/AdminScreenRouter.d.ts +13 -0
  40. package/dist/AdminScreenRouter.js +52 -0
  41. package/dist/AdminScreenRouter.js.map +1 -0
  42. package/dist/AdminScriptList.js +12 -10
  43. package/dist/AdminScriptList.js.map +1 -1
  44. package/dist/AdminShell.d.ts +2 -0
  45. package/dist/AdminShell.js +68 -21
  46. package/dist/AdminShell.js.map +1 -1
  47. package/dist/Constants.d.ts +4 -0
  48. package/dist/Constants.js +5 -0
  49. package/dist/Constants.js.map +1 -0
  50. package/dist/adminModelListQueryParams.d.ts +4 -0
  51. package/dist/adminModelListQueryParams.js +38 -3
  52. package/dist/adminModelListQueryParams.js.map +1 -1
  53. package/dist/adminPageAccess.d.ts +5 -0
  54. package/dist/adminPageAccess.js +19 -0
  55. package/dist/adminPageAccess.js.map +1 -0
  56. package/dist/index.d.ts +20 -1
  57. package/dist/index.js +18 -0
  58. package/dist/index.js.map +1 -1
  59. package/dist/types.d.ts +74 -0
  60. package/dist/types.js.map +1 -1
  61. package/dist/useAdminRoles.d.ts +65 -0
  62. package/dist/useAdminRoles.js +84 -0
  63. package/dist/useAdminRoles.js.map +1 -0
  64. package/dist/useDocumentStorageApi.js +2 -2
  65. package/dist/useDocumentStorageApi.js.map +1 -1
  66. package/dist/widgets/AIRequestsScreenWidget.d.ts +4 -0
  67. package/dist/widgets/AIRequestsScreenWidget.js +54 -0
  68. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -0
  69. package/dist/widgets/CustomScreensListWidget.d.ts +4 -0
  70. package/dist/widgets/CustomScreensListWidget.js +21 -0
  71. package/dist/widgets/CustomScreensListWidget.js.map +1 -0
  72. package/dist/widgets/DocumentsScreenWidget.d.ts +4 -0
  73. package/dist/widgets/DocumentsScreenWidget.js +9 -0
  74. package/dist/widgets/DocumentsScreenWidget.js.map +1 -0
  75. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +4 -0
  76. package/dist/widgets/FeatureFlagsOverridesWidget.js +18 -0
  77. package/dist/widgets/FeatureFlagsOverridesWidget.js.map +1 -0
  78. package/dist/widgets/MissingWidget.d.ts +7 -0
  79. package/dist/widgets/MissingWidget.js +6 -0
  80. package/dist/widgets/MissingWidget.js.map +1 -0
  81. package/dist/widgets/ModelsGridWidget.d.ts +3 -0
  82. package/dist/widgets/ModelsGridWidget.js +30 -0
  83. package/dist/widgets/ModelsGridWidget.js.map +1 -0
  84. package/dist/widgets/RecentActivityWidget.d.ts +3 -0
  85. package/dist/widgets/RecentActivityWidget.js +27 -0
  86. package/dist/widgets/RecentActivityWidget.js.map +1 -0
  87. package/dist/widgets/ScriptRunnerWidget.d.ts +3 -0
  88. package/dist/widgets/ScriptRunnerWidget.js +12 -0
  89. package/dist/widgets/ScriptRunnerWidget.js.map +1 -0
  90. package/dist/widgets/VersionConfigScreenWidget.d.ts +3 -0
  91. package/dist/widgets/VersionConfigScreenWidget.js +7 -0
  92. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -0
  93. package/dist/widgets/VersionConfigWidget.d.ts +3 -0
  94. package/dist/widgets/VersionConfigWidget.js +7 -0
  95. package/dist/widgets/VersionConfigWidget.js.map +1 -0
  96. package/dist/widgets/builtInFieldWidgets.d.ts +7 -0
  97. package/dist/widgets/builtInFieldWidgets.js +61 -0
  98. package/dist/widgets/builtInFieldWidgets.js.map +1 -0
  99. package/dist/widgets/builtInWidgets.d.ts +6 -0
  100. package/dist/widgets/builtInWidgets.js +31 -0
  101. package/dist/widgets/builtInWidgets.js.map +1 -0
  102. package/dist/widgets/consentWidgets.d.ts +3 -0
  103. package/dist/widgets/consentWidgets.js +8 -0
  104. package/dist/widgets/consentWidgets.js.map +1 -0
  105. package/dist/widgets/homeWidgetUtils.d.ts +3 -0
  106. package/dist/widgets/homeWidgetUtils.js +37 -0
  107. package/dist/widgets/homeWidgetUtils.js.map +1 -0
  108. package/package.json +3 -2
  109. package/src/AdminActionMenu.test.tsx +78 -0
  110. package/src/AdminActionMenu.tsx +106 -0
  111. package/src/AdminFieldRenderer.tsx +2 -0
  112. package/src/AdminFieldRendererCore.tsx +54 -133
  113. package/src/AdminFilterDrawer.test.tsx +89 -0
  114. package/src/AdminFilterDrawer.tsx +333 -0
  115. package/src/AdminHome.tsx +38 -325
  116. package/src/AdminModelForm.test.tsx +78 -0
  117. package/src/AdminModelForm.tsx +49 -10
  118. package/src/AdminModelList.tsx +7 -2
  119. package/src/AdminModelTable.test.tsx +73 -0
  120. package/src/AdminModelTable.tsx +108 -195
  121. package/src/AdminObjectPicker.tsx +49 -9
  122. package/src/AdminPrimitiveArrayField.tsx +5 -0
  123. package/src/AdminProvider.test.tsx +25 -0
  124. package/src/AdminProvider.tsx +121 -0
  125. package/src/AdminRefField.tsx +4 -0
  126. package/src/AdminRolesField.tsx +129 -0
  127. package/src/AdminRolesList.test.tsx +339 -0
  128. package/src/AdminRolesList.tsx +434 -0
  129. package/src/AdminScreenRouter.test.tsx +112 -0
  130. package/src/AdminScreenRouter.tsx +104 -0
  131. package/src/AdminScriptList.tsx +42 -30
  132. package/src/AdminShell.test.tsx +196 -1
  133. package/src/AdminShell.tsx +166 -69
  134. package/src/Constants.ts +5 -0
  135. package/src/adminModelListQueryParams.test.ts +69 -0
  136. package/src/adminModelListQueryParams.ts +49 -3
  137. package/src/adminPageAccess.test.ts +18 -0
  138. package/src/adminPageAccess.ts +18 -0
  139. package/src/index.tsx +51 -0
  140. package/src/isolated/AdminObjectPicker.isolated.tsx +10 -1
  141. package/src/types.ts +79 -0
  142. package/src/useAdminRoles.ts +146 -0
  143. package/src/useDocumentStorageApi.ts +2 -2
  144. package/src/widgets/AIRequestsScreenWidget.tsx +93 -0
  145. package/src/widgets/CustomScreensListWidget.tsx +56 -0
  146. package/src/widgets/DocumentsScreenWidget.tsx +11 -0
  147. package/src/widgets/FeatureFlagsOverridesWidget.tsx +48 -0
  148. package/src/widgets/MissingWidget.tsx +17 -0
  149. package/src/widgets/ModelsGridWidget.tsx +94 -0
  150. package/src/widgets/RecentActivityWidget.tsx +81 -0
  151. package/src/widgets/ScriptRunnerWidget.tsx +26 -0
  152. package/src/widgets/VersionConfigScreenWidget.tsx +12 -0
  153. package/src/widgets/VersionConfigWidget.tsx +7 -0
  154. package/src/widgets/builtInFieldWidgets.tsx +180 -0
  155. package/src/widgets/builtInWidgets.ts +51 -0
  156. package/src/widgets/consentWidgets.ts +13 -0
  157. package/src/widgets/homeWidgetUtils.ts +38 -0
  158. package/src/widgets/pluginWidgets.test.tsx +29 -0
@@ -0,0 +1,434 @@
1
+ import {
2
+ Badge,
3
+ Box,
4
+ Button,
5
+ CheckBox,
6
+ Heading,
7
+ Modal,
8
+ SelectField,
9
+ Spinner,
10
+ Text,
11
+ TextField,
12
+ } from "@terreno/ui";
13
+ import React, {useCallback, useMemo, useState} from "react";
14
+
15
+ import type {AdminScreenProps} from "./types";
16
+ import {resolveAdminBases} from "./types";
17
+ import {
18
+ normalizeRoles,
19
+ normalizeStatements,
20
+ type RbacRoleRow,
21
+ useAdminRoles,
22
+ } from "./useAdminRoles";
23
+
24
+ interface RoleFormState {
25
+ description: string;
26
+ displayName: string;
27
+ name: string;
28
+ permissions: Record<string, string[]>;
29
+ }
30
+
31
+ const EMPTY_ROLE_FORM: RoleFormState = {
32
+ description: "",
33
+ displayName: "",
34
+ name: "",
35
+ permissions: {},
36
+ };
37
+
38
+ const STANDARD_ACCESS_ACTIONS = ["read", "write", "writeOwned"] as const;
39
+ const STANDARD_ACCESS_OPTIONS = [
40
+ {label: "No access", value: "none"},
41
+ {label: "Read only", value: "read"},
42
+ {label: "Read + write owned", value: "writeOwned"},
43
+ {label: "Read + write all", value: "write"},
44
+ ];
45
+ const ADMIN_PAGE_RESOURCE = "admin";
46
+ const ADMIN_PAGE_ACTION = "access";
47
+
48
+ const editorActionsForResource = ({
49
+ actions,
50
+ hasStandardAccess,
51
+ resource,
52
+ }: {
53
+ actions: readonly string[];
54
+ hasStandardAccess: boolean;
55
+ resource: string;
56
+ }): readonly string[] => {
57
+ const withoutStandard = hasStandardAccess
58
+ ? actions.filter(
59
+ (action) =>
60
+ !STANDARD_ACCESS_ACTIONS.includes(action as (typeof STANDARD_ACCESS_ACTIONS)[number])
61
+ )
62
+ : actions;
63
+ if (resource === ADMIN_PAGE_RESOURCE) {
64
+ return withoutStandard.filter((action) => action !== ADMIN_PAGE_ACTION);
65
+ }
66
+ return withoutStandard;
67
+ };
68
+
69
+ const standardAccessValue = (actions: string[]): string => {
70
+ if (actions.includes("write")) {
71
+ return "write";
72
+ }
73
+ if (actions.includes("writeOwned")) {
74
+ return "writeOwned";
75
+ }
76
+ if (actions.includes("read")) {
77
+ return "read";
78
+ }
79
+ return "none";
80
+ };
81
+
82
+ const clonePermissions = (permissions?: Record<string, string[]>): Record<string, string[]> => {
83
+ return Object.fromEntries(
84
+ Object.entries(permissions ?? {}).map(([resource, actions]) => [resource, [...actions]])
85
+ );
86
+ };
87
+
88
+ export const AdminRolesList: React.FC<AdminScreenProps> = ({api, apiBase, baseUrl}) => {
89
+ const {apiBase: resolvedApiBase} = resolveAdminBases({apiBase, baseUrl});
90
+ const {useCreateRoleMutation, useListRolesQuery, useListStatementsQuery, useUpdateRoleMutation} =
91
+ useAdminRoles(api, resolvedApiBase);
92
+ const {data, error, isLoading, refetch} = useListRolesQuery();
93
+ const {
94
+ data: statementsData,
95
+ error: statementsError,
96
+ isLoading: areStatementsLoading,
97
+ } = useListStatementsQuery();
98
+ const [createRole, {isLoading: isCreating}] = useCreateRoleMutation();
99
+ const [updateRole, {isLoading: isUpdating}] = useUpdateRoleMutation();
100
+ const roles = normalizeRoles(data);
101
+ const statements = normalizeStatements(statementsData);
102
+ const resources = useMemo(() => Object.keys(statements).sort(), [statements]);
103
+ const hasAdminPageStatement =
104
+ statements[ADMIN_PAGE_RESOURCE]?.includes(ADMIN_PAGE_ACTION) ?? false;
105
+ const [editingRole, setEditingRole] = useState<RbacRoleRow | null>(null);
106
+ const [form, setForm] = useState<RoleFormState>(EMPTY_ROLE_FORM);
107
+ const [isFormVisible, setIsFormVisible] = useState(false);
108
+ const [saveError, setSaveError] = useState<string | null>(null);
109
+ const isSaving = isCreating || isUpdating;
110
+
111
+ const handleCreate = useCallback((): void => {
112
+ setEditingRole(null);
113
+ setForm(EMPTY_ROLE_FORM);
114
+ setSaveError(null);
115
+ setIsFormVisible(true);
116
+ }, []);
117
+
118
+ const handleEdit = useCallback((role: RbacRoleRow): void => {
119
+ setEditingRole(role);
120
+ setForm({
121
+ description: role.description ?? "",
122
+ displayName: role.displayName,
123
+ name: role.name,
124
+ permissions: clonePermissions(role.permissions),
125
+ });
126
+ setSaveError(null);
127
+ setIsFormVisible(true);
128
+ }, []);
129
+
130
+ const handleDismiss = useCallback((): void => {
131
+ setIsFormVisible(false);
132
+ setSaveError(null);
133
+ }, []);
134
+
135
+ const handleFieldChange = useCallback(
136
+ (field: "description" | "displayName" | "name", value: string): void => {
137
+ setForm((current) => ({...current, [field]: value}));
138
+ },
139
+ []
140
+ );
141
+
142
+ const handlePermissionToggle = useCallback((resource: string, action: string): void => {
143
+ setForm((current) => {
144
+ const currentActions = current.permissions[resource] ?? [];
145
+ const isSelected = currentActions.includes(action);
146
+ const nextActions = isSelected
147
+ ? currentActions.filter((item) => item !== action)
148
+ : [...currentActions, action].sort();
149
+ const permissions = {...current.permissions};
150
+ if (nextActions.length === 0) {
151
+ Reflect.deleteProperty(permissions, resource);
152
+ } else {
153
+ permissions[resource] = nextActions;
154
+ }
155
+ return {...current, permissions};
156
+ });
157
+ }, []);
158
+
159
+ const handleStandardAccessChange = useCallback((resource: string, value: string): void => {
160
+ setForm((current) => {
161
+ const customActions = (current.permissions[resource] ?? []).filter(
162
+ (action) =>
163
+ !STANDARD_ACCESS_ACTIONS.includes(action as (typeof STANDARD_ACCESS_ACTIONS)[number])
164
+ );
165
+ const standardActions = value === "none" ? [] : value === "read" ? ["read"] : ["read", value];
166
+ const nextActions = [...customActions, ...standardActions];
167
+ const permissions = {...current.permissions};
168
+ if (nextActions.length === 0) {
169
+ Reflect.deleteProperty(permissions, resource);
170
+ } else {
171
+ permissions[resource] = nextActions;
172
+ }
173
+ return {...current, permissions};
174
+ });
175
+ }, []);
176
+
177
+ const handleSave = useCallback(async (): Promise<void> => {
178
+ const name = form.name.trim();
179
+ const displayName = form.displayName.trim();
180
+ if (!name || !displayName) {
181
+ setSaveError("Name and display name are required.");
182
+ return;
183
+ }
184
+ setSaveError(null);
185
+ try {
186
+ if (editingRole) {
187
+ await updateRole({
188
+ changes: {
189
+ description: form.description.trim() === "" ? null : form.description.trim(),
190
+ displayName,
191
+ permissions: form.permissions,
192
+ },
193
+ roleName: editingRole.name,
194
+ }).unwrap();
195
+ } else {
196
+ await createRole({
197
+ description: form.description.trim() || undefined,
198
+ displayName,
199
+ name,
200
+ permissions: form.permissions,
201
+ }).unwrap();
202
+ }
203
+ setIsFormVisible(false);
204
+ refetch?.();
205
+ } catch (saveFailure: unknown) {
206
+ const data = (saveFailure as {data?: {detail?: string; title?: string}})?.data;
207
+ setSaveError(data?.detail ?? data?.title ?? "Failed to save role.");
208
+ }
209
+ }, [createRole, editingRole, form, refetch, updateRole]);
210
+
211
+ if (isLoading) {
212
+ return (
213
+ <Box alignItems="center" padding={4} testID="admin-roles-loading">
214
+ <Spinner />
215
+ </Box>
216
+ );
217
+ }
218
+
219
+ if (error) {
220
+ return (
221
+ <Box padding={4} testID="admin-roles-error">
222
+ <Text color="error">Failed to load roles.</Text>
223
+ </Box>
224
+ );
225
+ }
226
+
227
+ return (
228
+ <Box direction="column" flex="grow" minHeight={0} testID="admin-roles-list">
229
+ <Box
230
+ alignItems="center"
231
+ direction="row"
232
+ gap={2}
233
+ justifyContent="between"
234
+ paddingX={4}
235
+ paddingY={3}
236
+ >
237
+ <Heading size="lg">Roles</Heading>
238
+ <Button
239
+ iconName="plus"
240
+ onClick={handleCreate}
241
+ testID="admin-roles-add-button"
242
+ text="Add role"
243
+ />
244
+ </Box>
245
+ {/* Scrolls the role cards and permission vocabulary so a long list cannot push the
246
+ "Add role" action out of reach. */}
247
+ <Box flex="grow" minHeight={0} scroll testID="admin-roles-scroll">
248
+ <Box direction="column" gap={3} paddingX={4} paddingY={2}>
249
+ {roles.length === 0 ? (
250
+ <Text>No roles found.</Text>
251
+ ) : (
252
+ roles.map((role) => (
253
+ <Box
254
+ border="default"
255
+ direction="column"
256
+ gap={2}
257
+ key={role.name}
258
+ padding={3}
259
+ rounding="md"
260
+ testID={`admin-roles-item-${role.name}`}
261
+ >
262
+ <Box alignItems="center" direction="row" gap={2} justifyContent="between">
263
+ <Box alignItems="center" direction="row" gap={2}>
264
+ <Text bold size="md">
265
+ {role.displayName}
266
+ </Text>
267
+ {role.isLocked ? <Badge secondary status="info" value="locked" /> : null}
268
+ {role.isSealed ? <Badge secondary status="warning" value="sealed" /> : null}
269
+ </Box>
270
+ <Button
271
+ disabled={role.isSealed}
272
+ iconName="pen"
273
+ onClick={() => handleEdit(role)}
274
+ testID={`admin-roles-edit-${role.name}`}
275
+ text="Edit"
276
+ variant="outline"
277
+ />
278
+ </Box>
279
+ <Text color="secondaryLight" size="sm">
280
+ {role.name}
281
+ </Text>
282
+ {role.description ? <Text size="sm">{role.description}</Text> : null}
283
+ <Box direction="row" gap={1} wrap>
284
+ {Object.entries(role.permissions ?? {}).flatMap(([resource, actions]) =>
285
+ actions.map((action) => (
286
+ <Badge key={`${resource}:${action}`} value={`${resource}:${action}`} />
287
+ ))
288
+ )}
289
+ </Box>
290
+ </Box>
291
+ ))
292
+ )}
293
+
294
+ <Box border="default" gap={2} padding={3} rounding="md" testID="admin-permissions-list">
295
+ <Heading size="md">Available permissions</Heading>
296
+ {areStatementsLoading ? <Spinner /> : null}
297
+ {statementsError ? <Text color="error">Failed to load permissions.</Text> : null}
298
+ {!areStatementsLoading && !statementsError
299
+ ? resources.map((resource) => (
300
+ <Box gap={1} key={resource}>
301
+ <Text bold>{resource}</Text>
302
+ <Box direction="row" gap={1} wrap>
303
+ {statements[resource].map((action) => (
304
+ <Badge key={`${resource}:${action}`} value={`${resource}:${action}`} />
305
+ ))}
306
+ </Box>
307
+ </Box>
308
+ ))
309
+ : null}
310
+ </Box>
311
+ </Box>
312
+ </Box>
313
+
314
+ <Modal
315
+ onDismiss={handleDismiss}
316
+ primaryButtonDisabled={isSaving}
317
+ primaryButtonOnClick={handleSave}
318
+ primaryButtonText={editingRole ? "Save role" : "Create role"}
319
+ secondaryButtonOnClick={handleDismiss}
320
+ secondaryButtonText="Cancel"
321
+ size="lg"
322
+ testID="admin-role-modal"
323
+ testIDs={{primaryButton: "admin-role-save-button"}}
324
+ title={editingRole ? `Edit ${editingRole.displayName}` : "Add role"}
325
+ visible={isFormVisible}
326
+ >
327
+ <Box gap={3} testID="admin-role-form">
328
+ {saveError ? (
329
+ <Text color="error" testID="admin-role-save-error">
330
+ {saveError}
331
+ </Text>
332
+ ) : null}
333
+ <Box gap={4} maxHeight={360} overflow="scroll" padding={2}>
334
+ <TextField
335
+ disabled={Boolean(editingRole)}
336
+ onChange={(value) => handleFieldChange("name", value)}
337
+ testID="admin-role-name"
338
+ title="Name"
339
+ value={form.name}
340
+ />
341
+ <TextField
342
+ onChange={(value) => handleFieldChange("displayName", value)}
343
+ testID="admin-role-display-name"
344
+ title="Display name"
345
+ value={form.displayName}
346
+ />
347
+ <TextField
348
+ onChange={(value) => handleFieldChange("description", value)}
349
+ testID="admin-role-description"
350
+ title="Description"
351
+ value={form.description}
352
+ />
353
+ <Box gap={2} testID="admin-role-permissions">
354
+ <Heading size="sm">Permissions</Heading>
355
+ {hasAdminPageStatement ? (
356
+ <Box gap={2} testID="admin-role-page-access">
357
+ <Heading size="sm">Admin page</Heading>
358
+ <Text>
359
+ This is the only permission that opens the admin panel. Model and tool
360
+ permissions do not apply until it is granted.
361
+ </Text>
362
+ <Box
363
+ accessibilityHint="Toggles whether this role can open the admin page"
364
+ accessibilityLabel="Allow access to the admin page"
365
+ alignItems="center"
366
+ direction="row"
367
+ gap={1}
368
+ onClick={() => handlePermissionToggle(ADMIN_PAGE_RESOURCE, ADMIN_PAGE_ACTION)}
369
+ testID={`admin-role-permission-${ADMIN_PAGE_RESOURCE}-${ADMIN_PAGE_ACTION}`}
370
+ >
371
+ <CheckBox
372
+ selected={
373
+ form.permissions[ADMIN_PAGE_RESOURCE]?.includes(ADMIN_PAGE_ACTION) ?? false
374
+ }
375
+ />
376
+ <Text>Allow access to the admin page</Text>
377
+ </Box>
378
+ </Box>
379
+ ) : null}
380
+ {resources.map((resource) => {
381
+ const actions = statements[resource];
382
+ const hasStandardAccess = STANDARD_ACCESS_ACTIONS.every((action) =>
383
+ actions.includes(action)
384
+ );
385
+ const customActions = editorActionsForResource({
386
+ actions,
387
+ hasStandardAccess,
388
+ resource,
389
+ });
390
+ if (!hasStandardAccess && customActions.length === 0) {
391
+ return null;
392
+ }
393
+ return (
394
+ <Box gap={1} key={resource}>
395
+ <Text bold>{resource}</Text>
396
+ {hasStandardAccess ? (
397
+ <SelectField
398
+ onChange={(value: string) => handleStandardAccessChange(resource, value)}
399
+ options={STANDARD_ACCESS_OPTIONS}
400
+ testID={`admin-role-access-${resource}`}
401
+ title="Access level"
402
+ value={standardAccessValue(form.permissions[resource] ?? [])}
403
+ />
404
+ ) : null}
405
+ <Box direction="row" gap={3} wrap>
406
+ {customActions.map((action) => {
407
+ const isSelected = form.permissions[resource]?.includes(action) ?? false;
408
+ return (
409
+ <Box
410
+ accessibilityHint={`Toggles the ${action} permission for ${resource}`}
411
+ accessibilityLabel={`${resource} ${action}`}
412
+ alignItems="center"
413
+ direction="row"
414
+ gap={1}
415
+ key={`${resource}:${action}`}
416
+ onClick={() => handlePermissionToggle(resource, action)}
417
+ testID={`admin-role-permission-${resource}-${action}`}
418
+ >
419
+ <CheckBox selected={isSelected} />
420
+ <Text>{action}</Text>
421
+ </Box>
422
+ );
423
+ })}
424
+ </Box>
425
+ </Box>
426
+ );
427
+ })}
428
+ </Box>
429
+ </Box>
430
+ </Box>
431
+ </Modal>
432
+ </Box>
433
+ );
434
+ };
@@ -0,0 +1,112 @@
1
+ // biome-ignore-all lint/suspicious/noExplicitAny: test harness doubles
2
+ import {beforeEach, describe, expect, it, mock} from "bun:test";
3
+ import {renderWithTheme} from "@terreno/ui/src/test-utils";
4
+ import React from "react";
5
+ import type {AdminApi, AdminConfigResponse} from "./types";
6
+
7
+ mock.module("expo-router", () => ({
8
+ router: {push: mock(() => {})},
9
+ useNavigation: () => ({setOptions: mock(() => {})}),
10
+ }));
11
+
12
+ const configState: {config: AdminConfigResponse | null; isLoading: boolean} = {
13
+ config: null,
14
+ isLoading: false,
15
+ };
16
+
17
+ mock.module("./useAdminConfig", () => ({
18
+ useAdminConfig: () => ({
19
+ config: configState.config,
20
+ error: null,
21
+ isLoading: configState.isLoading,
22
+ }),
23
+ }));
24
+
25
+ mock.module("./useAdminApi", () => ({
26
+ useAdminApi: () => ({
27
+ useBulkPatchMutation: () => [mock(() => ({unwrap: async () => ({})})), {isLoading: false}],
28
+ useCreateMutation: () => [mock(() => ({unwrap: async () => ({})})), {isLoading: false}],
29
+ useDeleteMutation: () => [mock(() => ({unwrap: async () => ({})})), {isLoading: false}],
30
+ useListQuery: () => ({
31
+ data: {data: [], total: 0},
32
+ error: null,
33
+ isError: false,
34
+ isLoading: false,
35
+ refetch: mock(() => {}),
36
+ }),
37
+ useReadQuery: () => ({data: undefined, isLoading: false}),
38
+ useUpdateMutation: () => [mock(() => ({unwrap: async () => ({})})), {isLoading: false}],
39
+ }),
40
+ }));
41
+
42
+ mock.module("./useAdminBackgroundTask", () => ({
43
+ useAdminBackgroundTaskMutation: () => [mock(() => ({unwrap: async () => ({taskId: "t1"})}))],
44
+ }));
45
+
46
+ import {AdminScreenRouter} from "./AdminScreenRouter";
47
+
48
+ const adminApi = {
49
+ injectEndpoints: ({endpoints}: {endpoints: (builder: unknown) => Record<string, unknown>}) => {
50
+ endpoints({
51
+ mutation: (spec: Record<string, unknown>) => spec,
52
+ query: (spec: Record<string, unknown>) => spec,
53
+ });
54
+ return {
55
+ useAdminVersionConfigQuery: () => ({data: null, error: null, isLoading: false}),
56
+ useUpdateVersionConfigMutation: () => [
57
+ () => ({unwrap: async () => ({})}),
58
+ {isLoading: false},
59
+ ],
60
+ };
61
+ },
62
+ } as unknown as AdminApi;
63
+
64
+ const baseConfig: AdminConfigResponse = {
65
+ customScreens: [{displayName: "AI Admin", name: "ai-admin"}],
66
+ models: [
67
+ {
68
+ defaultSort: "-created",
69
+ displayName: "Foods",
70
+ fields: {name: {required: true, type: "string"}},
71
+ listFields: ["name"],
72
+ name: "Food",
73
+ routePath: "/admin/foods",
74
+ },
75
+ ],
76
+ scripts: [{description: "Test", name: "test-script"}],
77
+ };
78
+
79
+ describe("AdminScreenRouter", () => {
80
+ beforeEach(() => {
81
+ configState.config = baseConfig;
82
+ configState.isLoading = false;
83
+ });
84
+
85
+ it("renders AdminModelTable for a configured model name", () => {
86
+ const {getByTestId} = renderWithTheme(
87
+ <AdminScreenRouter api={adminApi} baseUrl="/admin" name="Food" />
88
+ );
89
+ expect(getByTestId("admin-list-Food")).toBeTruthy();
90
+ });
91
+
92
+ it("renders built-in version-config screen widget", () => {
93
+ const {getByText} = renderWithTheme(
94
+ <AdminScreenRouter api={adminApi} baseUrl="/admin" name="version-config" />
95
+ );
96
+ expect(getByText("Version Config")).toBeTruthy();
97
+ });
98
+
99
+ it("shows missing widget placeholder for unregistered custom screens", () => {
100
+ const {getByTestId} = renderWithTheme(
101
+ <AdminScreenRouter api={adminApi} baseUrl="/admin" name="ai-admin" />
102
+ );
103
+ expect(getByTestId("admin-missing-widget-ai-admin")).toBeTruthy();
104
+ });
105
+
106
+ it("returns not-found for unknown routes", () => {
107
+ const {getByTestId} = renderWithTheme(
108
+ <AdminScreenRouter api={adminApi} baseUrl="/admin" name="unknown-route" />
109
+ );
110
+ expect(getByTestId("admin-screen-not-found")).toBeTruthy();
111
+ });
112
+ });
@@ -0,0 +1,104 @@
1
+ import {Box, Page, Spinner, Text} from "@terreno/ui";
2
+ import React, {useMemo} from "react";
3
+ import {AdminModelTable} from "./AdminModelTable";
4
+ import {useAdminWidgetRegistry} from "./AdminProvider";
5
+ import {AdminScriptList} from "./AdminScriptList";
6
+ import type {AdminScreenProps} from "./types";
7
+ import {resolveAdminBases} from "./types";
8
+ import {useAdminConfig} from "./useAdminConfig";
9
+ import {MissingWidget} from "./widgets/MissingWidget";
10
+
11
+ export interface AdminScreenRouterProps extends AdminScreenProps {
12
+ /** Route segment: model name, custom screen name, or `__scripts`. */
13
+ name: string;
14
+ }
15
+
16
+ /**
17
+ * Resolves an admin route segment to a registered screen widget, model table, or scripts list.
18
+ *
19
+ * Custom screens require a matching entry in `AdminProvider.widgets.screens`. Model routes
20
+ * fall through to {@link AdminModelTable} when the name matches a configured model.
21
+ */
22
+ export const AdminScreenRouter: React.FC<AdminScreenRouterProps> = ({
23
+ name,
24
+ api,
25
+ baseUrl,
26
+ apiBase,
27
+ routeBase,
28
+ }) => {
29
+ const {apiBase: resolvedApiBase, routeBase: resolvedRouteBase} = resolveAdminBases({
30
+ apiBase,
31
+ baseUrl,
32
+ routeBase,
33
+ });
34
+ const {config, error, isLoading} = useAdminConfig(api, resolvedApiBase);
35
+ const registry = useAdminWidgetRegistry();
36
+
37
+ const model = useMemo(() => {
38
+ return config?.models.find((m) => m.name === name);
39
+ }, [config?.models, name]);
40
+
41
+ const customScreen = useMemo(() => {
42
+ return config?.customScreens?.find((screen) => screen.name === name);
43
+ }, [config?.customScreens, name]);
44
+
45
+ if (isLoading) {
46
+ return (
47
+ <Box alignItems="center" justifyContent="center" padding={6} testID="admin-screen-loading">
48
+ <Spinner />
49
+ </Box>
50
+ );
51
+ }
52
+
53
+ if (error || !config) {
54
+ return (
55
+ <Box padding={4} testID="admin-screen-error">
56
+ <Text color="error">Failed to load admin configuration.</Text>
57
+ </Box>
58
+ );
59
+ }
60
+
61
+ if (name === "__scripts") {
62
+ return <AdminScriptList api={api} apiBase={resolvedApiBase} routeBase={resolvedRouteBase} />;
63
+ }
64
+
65
+ if (model) {
66
+ return (
67
+ <AdminModelTable
68
+ api={api}
69
+ apiBase={resolvedApiBase}
70
+ modelName={name}
71
+ routeBase={resolvedRouteBase}
72
+ />
73
+ );
74
+ }
75
+
76
+ const ScreenWidget = registry.screens[name];
77
+ if (ScreenWidget) {
78
+ return (
79
+ <ScreenWidget
80
+ api={api}
81
+ apiBase={resolvedApiBase}
82
+ config={config}
83
+ routeBase={resolvedRouteBase}
84
+ screenName={name}
85
+ />
86
+ );
87
+ }
88
+
89
+ if (customScreen) {
90
+ return (
91
+ <Page color="transparent" maxWidth="100%" padding={4} title={customScreen.displayName}>
92
+ <MissingWidget bucket="screens" widgetId={name} />
93
+ </Page>
94
+ );
95
+ }
96
+
97
+ return (
98
+ <Page color="transparent" maxWidth="100%" padding={4} title="Not found">
99
+ <Box testID="admin-screen-not-found">
100
+ <Text color="error">{`No admin screen or model registered for "${name}".`}</Text>
101
+ </Box>
102
+ </Page>
103
+ );
104
+ };