@terreno/admin-frontend 57.0.0 → 57.1.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 (150) 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 +15 -3
  16. package/dist/AdminModelForm.js.map +1 -1
  17. package/dist/AdminModelList.d.ts +2 -1
  18. package/dist/AdminModelList.js +2 -0
  19. package/dist/AdminModelList.js.map +1 -1
  20. package/dist/AdminModelTable.js +54 -97
  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 +126 -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/AdminShell.d.ts +2 -0
  43. package/dist/AdminShell.js +53 -19
  44. package/dist/AdminShell.js.map +1 -1
  45. package/dist/Constants.d.ts +4 -0
  46. package/dist/Constants.js +5 -0
  47. package/dist/Constants.js.map +1 -0
  48. package/dist/adminModelListQueryParams.d.ts +4 -0
  49. package/dist/adminModelListQueryParams.js +38 -3
  50. package/dist/adminModelListQueryParams.js.map +1 -1
  51. package/dist/index.d.ts +19 -1
  52. package/dist/index.js +17 -0
  53. package/dist/index.js.map +1 -1
  54. package/dist/types.d.ts +61 -0
  55. package/dist/types.js.map +1 -1
  56. package/dist/useAdminRoles.d.ts +65 -0
  57. package/dist/useAdminRoles.js +84 -0
  58. package/dist/useAdminRoles.js.map +1 -0
  59. package/dist/useDocumentStorageApi.js +2 -2
  60. package/dist/useDocumentStorageApi.js.map +1 -1
  61. package/dist/widgets/AIRequestsScreenWidget.d.ts +4 -0
  62. package/dist/widgets/AIRequestsScreenWidget.js +54 -0
  63. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -0
  64. package/dist/widgets/CustomScreensListWidget.d.ts +4 -0
  65. package/dist/widgets/CustomScreensListWidget.js +21 -0
  66. package/dist/widgets/CustomScreensListWidget.js.map +1 -0
  67. package/dist/widgets/DocumentsScreenWidget.d.ts +4 -0
  68. package/dist/widgets/DocumentsScreenWidget.js +9 -0
  69. package/dist/widgets/DocumentsScreenWidget.js.map +1 -0
  70. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +4 -0
  71. package/dist/widgets/FeatureFlagsOverridesWidget.js +18 -0
  72. package/dist/widgets/FeatureFlagsOverridesWidget.js.map +1 -0
  73. package/dist/widgets/MissingWidget.d.ts +7 -0
  74. package/dist/widgets/MissingWidget.js +6 -0
  75. package/dist/widgets/MissingWidget.js.map +1 -0
  76. package/dist/widgets/ModelsGridWidget.d.ts +3 -0
  77. package/dist/widgets/ModelsGridWidget.js +30 -0
  78. package/dist/widgets/ModelsGridWidget.js.map +1 -0
  79. package/dist/widgets/RecentActivityWidget.d.ts +3 -0
  80. package/dist/widgets/RecentActivityWidget.js +27 -0
  81. package/dist/widgets/RecentActivityWidget.js.map +1 -0
  82. package/dist/widgets/ScriptRunnerWidget.d.ts +3 -0
  83. package/dist/widgets/ScriptRunnerWidget.js +12 -0
  84. package/dist/widgets/ScriptRunnerWidget.js.map +1 -0
  85. package/dist/widgets/VersionConfigScreenWidget.d.ts +3 -0
  86. package/dist/widgets/VersionConfigScreenWidget.js +7 -0
  87. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -0
  88. package/dist/widgets/VersionConfigWidget.d.ts +3 -0
  89. package/dist/widgets/VersionConfigWidget.js +7 -0
  90. package/dist/widgets/VersionConfigWidget.js.map +1 -0
  91. package/dist/widgets/builtInFieldWidgets.d.ts +7 -0
  92. package/dist/widgets/builtInFieldWidgets.js +61 -0
  93. package/dist/widgets/builtInFieldWidgets.js.map +1 -0
  94. package/dist/widgets/builtInWidgets.d.ts +6 -0
  95. package/dist/widgets/builtInWidgets.js +31 -0
  96. package/dist/widgets/builtInWidgets.js.map +1 -0
  97. package/dist/widgets/consentWidgets.d.ts +3 -0
  98. package/dist/widgets/consentWidgets.js +8 -0
  99. package/dist/widgets/consentWidgets.js.map +1 -0
  100. package/dist/widgets/homeWidgetUtils.d.ts +3 -0
  101. package/dist/widgets/homeWidgetUtils.js +37 -0
  102. package/dist/widgets/homeWidgetUtils.js.map +1 -0
  103. package/package.json +3 -2
  104. package/src/AdminActionMenu.test.tsx +78 -0
  105. package/src/AdminActionMenu.tsx +106 -0
  106. package/src/AdminFieldRenderer.tsx +2 -0
  107. package/src/AdminFieldRendererCore.tsx +54 -133
  108. package/src/AdminFilterDrawer.test.tsx +89 -0
  109. package/src/AdminFilterDrawer.tsx +333 -0
  110. package/src/AdminHome.tsx +38 -325
  111. package/src/AdminModelForm.test.tsx +45 -0
  112. package/src/AdminModelForm.tsx +24 -1
  113. package/src/AdminModelList.tsx +4 -1
  114. package/src/AdminModelTable.test.tsx +73 -0
  115. package/src/AdminModelTable.tsx +105 -194
  116. package/src/AdminObjectPicker.tsx +49 -9
  117. package/src/AdminPrimitiveArrayField.tsx +5 -0
  118. package/src/AdminProvider.test.tsx +25 -0
  119. package/src/AdminProvider.tsx +121 -0
  120. package/src/AdminRefField.tsx +4 -0
  121. package/src/AdminRolesField.tsx +129 -0
  122. package/src/AdminRolesList.test.tsx +257 -0
  123. package/src/AdminRolesList.tsx +311 -0
  124. package/src/AdminScreenRouter.test.tsx +112 -0
  125. package/src/AdminScreenRouter.tsx +104 -0
  126. package/src/AdminShell.test.tsx +107 -1
  127. package/src/AdminShell.tsx +143 -67
  128. package/src/Constants.ts +5 -0
  129. package/src/adminModelListQueryParams.test.ts +69 -0
  130. package/src/adminModelListQueryParams.ts +49 -3
  131. package/src/index.tsx +50 -0
  132. package/src/isolated/AdminObjectPicker.isolated.tsx +10 -1
  133. package/src/types.ts +65 -0
  134. package/src/useAdminRoles.ts +146 -0
  135. package/src/useDocumentStorageApi.ts +2 -2
  136. package/src/widgets/AIRequestsScreenWidget.tsx +93 -0
  137. package/src/widgets/CustomScreensListWidget.tsx +56 -0
  138. package/src/widgets/DocumentsScreenWidget.tsx +11 -0
  139. package/src/widgets/FeatureFlagsOverridesWidget.tsx +48 -0
  140. package/src/widgets/MissingWidget.tsx +17 -0
  141. package/src/widgets/ModelsGridWidget.tsx +94 -0
  142. package/src/widgets/RecentActivityWidget.tsx +81 -0
  143. package/src/widgets/ScriptRunnerWidget.tsx +26 -0
  144. package/src/widgets/VersionConfigScreenWidget.tsx +12 -0
  145. package/src/widgets/VersionConfigWidget.tsx +7 -0
  146. package/src/widgets/builtInFieldWidgets.tsx +180 -0
  147. package/src/widgets/builtInWidgets.ts +51 -0
  148. package/src/widgets/consentWidgets.ts +13 -0
  149. package/src/widgets/homeWidgetUtils.ts +38 -0
  150. package/src/widgets/pluginWidgets.test.tsx +29 -0
@@ -0,0 +1,311 @@
1
+ import {Badge, Box, Button, CheckBox, Heading, Modal, Spinner, Text, TextField} from "@terreno/ui";
2
+ import React, {useCallback, useMemo, useState} from "react";
3
+
4
+ import type {AdminScreenProps} from "./types";
5
+ import {resolveAdminBases} from "./types";
6
+ import {
7
+ normalizeRoles,
8
+ normalizeStatements,
9
+ type RbacRoleRow,
10
+ useAdminRoles,
11
+ } from "./useAdminRoles";
12
+
13
+ interface RoleFormState {
14
+ description: string;
15
+ displayName: string;
16
+ name: string;
17
+ permissions: Record<string, string[]>;
18
+ }
19
+
20
+ const EMPTY_ROLE_FORM: RoleFormState = {
21
+ description: "",
22
+ displayName: "",
23
+ name: "",
24
+ permissions: {},
25
+ };
26
+
27
+ const clonePermissions = (permissions?: Record<string, string[]>): Record<string, string[]> => {
28
+ return Object.fromEntries(
29
+ Object.entries(permissions ?? {}).map(([resource, actions]) => [resource, [...actions]])
30
+ );
31
+ };
32
+
33
+ export const AdminRolesList: React.FC<AdminScreenProps> = ({api, apiBase, baseUrl}) => {
34
+ const {apiBase: resolvedApiBase} = resolveAdminBases({apiBase, baseUrl});
35
+ const {useCreateRoleMutation, useListRolesQuery, useListStatementsQuery, useUpdateRoleMutation} =
36
+ useAdminRoles(api, resolvedApiBase);
37
+ const {data, error, isLoading, refetch} = useListRolesQuery();
38
+ const {
39
+ data: statementsData,
40
+ error: statementsError,
41
+ isLoading: areStatementsLoading,
42
+ } = useListStatementsQuery();
43
+ const [createRole, {isLoading: isCreating}] = useCreateRoleMutation();
44
+ const [updateRole, {isLoading: isUpdating}] = useUpdateRoleMutation();
45
+ const roles = normalizeRoles(data);
46
+ const statements = normalizeStatements(statementsData);
47
+ const resources = useMemo(() => Object.keys(statements).sort(), [statements]);
48
+ const [editingRole, setEditingRole] = useState<RbacRoleRow | null>(null);
49
+ const [form, setForm] = useState<RoleFormState>(EMPTY_ROLE_FORM);
50
+ const [isFormVisible, setIsFormVisible] = useState(false);
51
+ const [saveError, setSaveError] = useState<string | null>(null);
52
+ const isSaving = isCreating || isUpdating;
53
+
54
+ const handleCreate = useCallback((): void => {
55
+ setEditingRole(null);
56
+ setForm(EMPTY_ROLE_FORM);
57
+ setSaveError(null);
58
+ setIsFormVisible(true);
59
+ }, []);
60
+
61
+ const handleEdit = useCallback((role: RbacRoleRow): void => {
62
+ setEditingRole(role);
63
+ setForm({
64
+ description: role.description ?? "",
65
+ displayName: role.displayName,
66
+ name: role.name,
67
+ permissions: clonePermissions(role.permissions),
68
+ });
69
+ setSaveError(null);
70
+ setIsFormVisible(true);
71
+ }, []);
72
+
73
+ const handleDismiss = useCallback((): void => {
74
+ setIsFormVisible(false);
75
+ setSaveError(null);
76
+ }, []);
77
+
78
+ const handleFieldChange = useCallback(
79
+ (field: "description" | "displayName" | "name", value: string): void => {
80
+ setForm((current) => ({...current, [field]: value}));
81
+ },
82
+ []
83
+ );
84
+
85
+ const handlePermissionToggle = useCallback((resource: string, action: string): void => {
86
+ setForm((current) => {
87
+ const currentActions = current.permissions[resource] ?? [];
88
+ const isSelected = currentActions.includes(action);
89
+ const nextActions = isSelected
90
+ ? currentActions.filter((item) => item !== action)
91
+ : [...currentActions, action].sort();
92
+ const permissions = {...current.permissions};
93
+ if (nextActions.length === 0) {
94
+ Reflect.deleteProperty(permissions, resource);
95
+ } else {
96
+ permissions[resource] = nextActions;
97
+ }
98
+ return {...current, permissions};
99
+ });
100
+ }, []);
101
+
102
+ const handleSave = useCallback(async (): Promise<void> => {
103
+ const name = form.name.trim();
104
+ const displayName = form.displayName.trim();
105
+ if (!name || !displayName) {
106
+ setSaveError("Name and display name are required.");
107
+ return;
108
+ }
109
+ setSaveError(null);
110
+ try {
111
+ if (editingRole) {
112
+ await updateRole({
113
+ changes: {
114
+ description: form.description.trim() === "" ? null : form.description.trim(),
115
+ displayName,
116
+ permissions: form.permissions,
117
+ },
118
+ roleName: editingRole.name,
119
+ }).unwrap();
120
+ } else {
121
+ await createRole({
122
+ description: form.description.trim() || undefined,
123
+ displayName,
124
+ name,
125
+ permissions: form.permissions,
126
+ }).unwrap();
127
+ }
128
+ setIsFormVisible(false);
129
+ refetch?.();
130
+ } catch (saveFailure: unknown) {
131
+ const data = (saveFailure as {data?: {detail?: string; title?: string}})?.data;
132
+ setSaveError(data?.detail ?? data?.title ?? "Failed to save role.");
133
+ }
134
+ }, [createRole, editingRole, form, refetch, updateRole]);
135
+
136
+ if (isLoading) {
137
+ return (
138
+ <Box alignItems="center" padding={4} testID="admin-roles-loading">
139
+ <Spinner />
140
+ </Box>
141
+ );
142
+ }
143
+
144
+ if (error) {
145
+ return (
146
+ <Box padding={4} testID="admin-roles-error">
147
+ <Text color="error">Failed to load roles.</Text>
148
+ </Box>
149
+ );
150
+ }
151
+
152
+ return (
153
+ <Box direction="column" flex="grow" minHeight={0} testID="admin-roles-list">
154
+ <Box
155
+ alignItems="center"
156
+ direction="row"
157
+ gap={2}
158
+ justifyContent="between"
159
+ paddingX={4}
160
+ paddingY={3}
161
+ >
162
+ <Heading size="lg">Roles</Heading>
163
+ <Button
164
+ iconName="plus"
165
+ onClick={handleCreate}
166
+ testID="admin-roles-add-button"
167
+ text="Add role"
168
+ />
169
+ </Box>
170
+ {/* Scrolls the role cards and permission vocabulary so a long list cannot push the
171
+ "Add role" action out of reach. */}
172
+ <Box flex="grow" minHeight={0} scroll testID="admin-roles-scroll">
173
+ <Box direction="column" gap={3} paddingX={4} paddingY={2}>
174
+ {roles.length === 0 ? (
175
+ <Text>No roles found.</Text>
176
+ ) : (
177
+ roles.map((role) => (
178
+ <Box
179
+ border="default"
180
+ direction="column"
181
+ gap={2}
182
+ key={role.name}
183
+ padding={3}
184
+ rounding="md"
185
+ testID={`admin-roles-item-${role.name}`}
186
+ >
187
+ <Box alignItems="center" direction="row" gap={2} justifyContent="between">
188
+ <Box alignItems="center" direction="row" gap={2}>
189
+ <Text bold size="md">
190
+ {role.displayName}
191
+ </Text>
192
+ {role.isLocked ? <Badge secondary status="info" value="locked" /> : null}
193
+ {role.isSealed ? <Badge secondary status="warning" value="sealed" /> : null}
194
+ </Box>
195
+ <Button
196
+ disabled={role.isSealed}
197
+ iconName="pen"
198
+ onClick={() => handleEdit(role)}
199
+ testID={`admin-roles-edit-${role.name}`}
200
+ text="Edit"
201
+ variant="outline"
202
+ />
203
+ </Box>
204
+ <Text color="secondaryLight" size="sm">
205
+ {role.name}
206
+ </Text>
207
+ {role.description ? <Text size="sm">{role.description}</Text> : null}
208
+ <Box direction="row" gap={1} wrap>
209
+ {Object.entries(role.permissions ?? {}).flatMap(([resource, actions]) =>
210
+ actions.map((action) => (
211
+ <Badge key={`${resource}:${action}`} value={`${resource}:${action}`} />
212
+ ))
213
+ )}
214
+ </Box>
215
+ </Box>
216
+ ))
217
+ )}
218
+
219
+ <Box border="default" gap={2} padding={3} rounding="md" testID="admin-permissions-list">
220
+ <Heading size="md">Available permissions</Heading>
221
+ {areStatementsLoading ? <Spinner /> : null}
222
+ {statementsError ? <Text color="error">Failed to load permissions.</Text> : null}
223
+ {!areStatementsLoading && !statementsError
224
+ ? resources.map((resource) => (
225
+ <Box gap={1} key={resource}>
226
+ <Text bold>{resource}</Text>
227
+ <Box direction="row" gap={1} wrap>
228
+ {statements[resource].map((action) => (
229
+ <Badge key={`${resource}:${action}`} value={`${resource}:${action}`} />
230
+ ))}
231
+ </Box>
232
+ </Box>
233
+ ))
234
+ : null}
235
+ </Box>
236
+ </Box>
237
+ </Box>
238
+
239
+ <Modal
240
+ onDismiss={handleDismiss}
241
+ primaryButtonDisabled={isSaving}
242
+ primaryButtonOnClick={handleSave}
243
+ primaryButtonText={editingRole ? "Save role" : "Create role"}
244
+ secondaryButtonOnClick={handleDismiss}
245
+ secondaryButtonText="Cancel"
246
+ size="lg"
247
+ testID="admin-role-modal"
248
+ testIDs={{primaryButton: "admin-role-save-button"}}
249
+ title={editingRole ? `Edit ${editingRole.displayName}` : "Add role"}
250
+ visible={isFormVisible}
251
+ >
252
+ <Box gap={3} testID="admin-role-form">
253
+ {saveError ? (
254
+ <Text color="error" testID="admin-role-save-error">
255
+ {saveError}
256
+ </Text>
257
+ ) : null}
258
+ <Box gap={4} maxHeight={360} overflow="scroll" padding={2}>
259
+ <TextField
260
+ disabled={Boolean(editingRole)}
261
+ onChange={(value) => handleFieldChange("name", value)}
262
+ testID="admin-role-name"
263
+ title="Name"
264
+ value={form.name}
265
+ />
266
+ <TextField
267
+ onChange={(value) => handleFieldChange("displayName", value)}
268
+ testID="admin-role-display-name"
269
+ title="Display name"
270
+ value={form.displayName}
271
+ />
272
+ <TextField
273
+ onChange={(value) => handleFieldChange("description", value)}
274
+ testID="admin-role-description"
275
+ title="Description"
276
+ value={form.description}
277
+ />
278
+ <Box gap={2} testID="admin-role-permissions">
279
+ <Heading size="sm">Permissions</Heading>
280
+ {resources.map((resource) => (
281
+ <Box gap={1} key={resource}>
282
+ <Text bold>{resource}</Text>
283
+ <Box direction="row" gap={3} wrap>
284
+ {statements[resource].map((action) => {
285
+ const isSelected = form.permissions[resource]?.includes(action) ?? false;
286
+ return (
287
+ <Box
288
+ accessibilityHint={`Toggles the ${action} permission for ${resource}`}
289
+ accessibilityLabel={`${resource} ${action}`}
290
+ alignItems="center"
291
+ direction="row"
292
+ gap={1}
293
+ key={`${resource}:${action}`}
294
+ onClick={() => handlePermissionToggle(resource, action)}
295
+ testID={`admin-role-permission-${resource}-${action}`}
296
+ >
297
+ <CheckBox selected={isSelected} />
298
+ <Text>{action}</Text>
299
+ </Box>
300
+ );
301
+ })}
302
+ </Box>
303
+ </Box>
304
+ ))}
305
+ </Box>
306
+ </Box>
307
+ </Box>
308
+ </Modal>
309
+ </Box>
310
+ );
311
+ };
@@ -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
+ };
@@ -7,7 +7,7 @@ import React from "react";
7
7
  import type {ScaledSize} from "react-native";
8
8
  import {useWindowDimensions} from "react-native";
9
9
  import {SafeAreaView} from "react-native-safe-area-context";
10
- import type {AdminApi, AdminConfigResponse} from "./types";
10
+ import type {AdminApi, AdminConfigResponse, AdminModelConfig} from "./types";
11
11
 
12
12
  const mockRouterPush = mock((_href: string) => {});
13
13
 
@@ -79,6 +79,20 @@ const buildConfig = (): AdminConfigResponse => ({
79
79
  scripts: [{description: "Seed", name: "seed"}],
80
80
  });
81
81
 
82
+ const platformModel = ({
83
+ displayName,
84
+ name,
85
+ routePath,
86
+ }: Pick<AdminModelConfig, "displayName" | "name" | "routePath">): AdminModelConfig => ({
87
+ defaultSort: "-created",
88
+ displayName,
89
+ fields: {name: {required: true, type: "string"}},
90
+ group: "Platform",
91
+ listFields: ["name"],
92
+ name,
93
+ routePath,
94
+ });
95
+
82
96
  const mockApi = {} as unknown as AdminApi;
83
97
 
84
98
  describe("AdminShell", () => {
@@ -188,4 +202,96 @@ describe("AdminShell", () => {
188
202
  expect(mockRouterPush).toHaveBeenCalled();
189
203
  expect(queryByTestId("admin-shell-drawer")).toBeNull();
190
204
  });
205
+
206
+ it("renders the ordered Platform block last and removes its models from Models", async () => {
207
+ restoreWindowWidth?.();
208
+ restoreWindowWidth = setWindowWidth(1024);
209
+ configState.config = {
210
+ ...buildConfig(),
211
+ models: [
212
+ ...buildConfig().models,
213
+ platformModel({
214
+ displayName: "Audit Logs",
215
+ name: "AdminAuditLog",
216
+ routePath: "/admin/audit-logs",
217
+ }),
218
+ platformModel({
219
+ displayName: "Feature Flags",
220
+ name: "FeatureFlag",
221
+ routePath: "/admin/feature-flags",
222
+ }),
223
+ ],
224
+ };
225
+
226
+ const {getByTestId, queryByTestId, queryByText} = renderWithTheme(
227
+ <AdminShell
228
+ api={mockApi}
229
+ apiBase="/admin"
230
+ configurationPath="/admin/configuration"
231
+ rolesPath="/roles"
232
+ routeBase="/admin"
233
+ >
234
+ <React.Fragment />
235
+ </AdminShell>
236
+ );
237
+
238
+ const platform = getByTestId("admin-shell-nav-platform");
239
+ const platformLinkTestIDs = platform
240
+ .findAll((node: ReactTestInstance) => typeof node.props.testID === "string")
241
+ .map((node: ReactTestInstance) => node.props.testID)
242
+ .filter((testID: string) => testID.startsWith("admin-shell-nav-"))
243
+ .filter((testID: string) => !testID.endsWith("-clickable"))
244
+ .filter((testID: string, index: number, testIDs: string[]) => {
245
+ return testIDs.indexOf(testID) === index;
246
+ });
247
+ expect(platformLinkTestIDs).toEqual([
248
+ "admin-shell-nav-platform",
249
+ "admin-shell-nav-scripts",
250
+ "admin-shell-nav-roles",
251
+ "admin-shell-nav-version",
252
+ "admin-shell-nav-audit-log",
253
+ "admin-shell-nav-feature-flags",
254
+ "admin-shell-nav-configuration",
255
+ ]);
256
+ expect(queryByText("Tools")).toBeNull();
257
+ expect(queryByTestId("admin-shell-nav-model-AdminAuditLog")).toBeNull();
258
+ expect(queryByTestId("admin-shell-nav-model-FeatureFlag")).toBeNull();
259
+
260
+ await act(async () => {
261
+ fireEvent.press(getByTestId("admin-shell-nav-audit-log-clickable"));
262
+ });
263
+ expect(mockRouterPush).toHaveBeenLastCalledWith("/admin/AdminAuditLog");
264
+ });
265
+
266
+ it("hides empty Models and Screens headings", () => {
267
+ restoreWindowWidth?.();
268
+ restoreWindowWidth = setWindowWidth(1024);
269
+ configState.config = {
270
+ customScreens: [],
271
+ models: [
272
+ platformModel({
273
+ displayName: "Audit Logs",
274
+ name: "AdminAuditLog",
275
+ routePath: "/admin/audit-logs",
276
+ }),
277
+ platformModel({
278
+ displayName: "Feature Flags",
279
+ name: "FeatureFlag",
280
+ routePath: "/admin/feature-flags",
281
+ }),
282
+ ],
283
+ scripts: [],
284
+ };
285
+
286
+ const {getByText, queryByText} = renderWithTheme(
287
+ <AdminShell api={mockApi} apiBase="/admin" routeBase="/admin">
288
+ <React.Fragment />
289
+ </AdminShell>
290
+ );
291
+
292
+ expect(queryByText("Models")).toBeNull();
293
+ expect(queryByText("Screens")).toBeNull();
294
+ expect(queryByText("Tools")).toBeNull();
295
+ expect(getByText("Platform")).toBeTruthy();
296
+ });
191
297
  });