@terreno/admin-frontend 0.20.2 → 0.22.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.
- package/.ai/guidelines/core.md +10 -0
- package/dist/AdminBreadcrumbs.d.ts +13 -0
- package/dist/AdminBreadcrumbs.js +22 -0
- package/dist/AdminBreadcrumbs.js.map +1 -0
- package/dist/AdminFieldRenderer.js +3 -3
- package/dist/AdminFieldRenderer.js.map +1 -1
- package/dist/AdminFieldRendererCore.d.ts +2 -0
- package/dist/AdminFieldRendererCore.js +28 -18
- package/dist/AdminFieldRendererCore.js.map +1 -1
- package/dist/AdminHome.d.ts +22 -0
- package/dist/AdminHome.js +189 -0
- package/dist/AdminHome.js.map +1 -0
- package/dist/AdminModelForm.d.ts +24 -1
- package/dist/AdminModelForm.js +185 -14
- package/dist/AdminModelForm.js.map +1 -1
- package/dist/AdminModelList.d.ts +4 -0
- package/dist/AdminModelList.js +19 -4
- package/dist/AdminModelList.js.map +1 -1
- package/dist/AdminModelTable.d.ts +2 -27
- package/dist/AdminModelTable.js +316 -60
- package/dist/AdminModelTable.js.map +1 -1
- package/dist/AdminNestedArrayField.d.ts +1 -0
- package/dist/AdminNestedArrayField.js +26 -6
- package/dist/AdminNestedArrayField.js.map +1 -1
- package/dist/AdminObjectPicker.d.ts +1 -0
- package/dist/AdminObjectPicker.js +6 -2
- package/dist/AdminObjectPicker.js.map +1 -1
- package/dist/AdminPrimitiveArrayField.d.ts +1 -0
- package/dist/AdminPrimitiveArrayField.js +9 -8
- package/dist/AdminPrimitiveArrayField.js.map +1 -1
- package/dist/AdminRefField.js +2 -2
- package/dist/AdminRefField.js.map +1 -1
- package/dist/AdminScriptList.js +114 -7
- package/dist/AdminScriptList.js.map +1 -1
- package/dist/AdminScriptRunModal.d.ts +5 -0
- package/dist/AdminScriptRunModal.js +136 -30
- package/dist/AdminScriptRunModal.js.map +1 -1
- package/dist/AdminShell.d.ts +39 -0
- package/dist/AdminShell.js +80 -0
- package/dist/AdminShell.js.map +1 -0
- package/dist/AdminShellLayout.d.ts +23 -0
- package/dist/AdminShellLayout.js +32 -0
- package/dist/AdminShellLayout.js.map +1 -0
- package/dist/AdminVersionConfig.d.ts +5 -0
- package/dist/AdminVersionConfig.js +15 -5
- package/dist/AdminVersionConfig.js.map +1 -1
- package/dist/ConfigurationScreen.js +3 -3
- package/dist/ConfigurationScreen.js.map +1 -1
- package/dist/ConsentFormEditor.js +2 -2
- package/dist/ConsentFormEditor.js.map +1 -1
- package/dist/ConsentFormList.js +1 -1
- package/dist/ConsentFormList.js.map +1 -1
- package/dist/ConsentResponseViewer.js +3 -3
- package/dist/ConsentResponseViewer.js.map +1 -1
- package/dist/DocumentStorageBrowser.js +1 -1
- package/dist/DocumentStorageBrowser.js.map +1 -1
- package/dist/adminModelListQueryParams.d.ts +14 -0
- package/dist/adminModelListQueryParams.js +51 -0
- package/dist/adminModelListQueryParams.js.map +1 -0
- package/dist/adminShellNav.d.ts +10 -0
- package/dist/adminShellNav.js +29 -0
- package/dist/adminShellNav.js.map +1 -0
- package/dist/index.d.ts +6 -1
- package/dist/index.js +5 -0
- package/dist/index.js.map +1 -1
- package/dist/scriptRunUtils.d.ts +36 -0
- package/dist/scriptRunUtils.js +121 -0
- package/dist/scriptRunUtils.js.map +1 -0
- package/dist/types.d.ts +70 -0
- package/dist/types.js.map +1 -1
- package/dist/useAdminApi.d.ts +1 -0
- package/dist/useAdminApi.js +11 -0
- package/dist/useAdminApi.js.map +1 -1
- package/dist/useAdminBackgroundTask.d.ts +12 -0
- package/dist/useAdminBackgroundTask.js +26 -0
- package/dist/useAdminBackgroundTask.js.map +1 -0
- package/dist/useAdminScripts.d.ts +19 -1
- package/dist/useAdminScripts.js +33 -4
- package/dist/useAdminScripts.js.map +1 -1
- package/package.json +4 -3
- package/src/AdminBreadcrumbs.test.tsx +27 -0
- package/src/AdminBreadcrumbs.tsx +63 -0
- package/src/AdminFieldRenderer.tsx +3 -0
- package/src/AdminFieldRendererCore.tsx +59 -1
- package/src/AdminHome.test.tsx +208 -0
- package/src/AdminHome.tsx +474 -0
- package/src/AdminModelForm.test.tsx +81 -1
- package/src/AdminModelForm.tsx +282 -34
- package/src/AdminModelList.test.tsx +1 -1
- package/src/AdminModelList.tsx +72 -39
- package/src/AdminModelTable.test.tsx +11 -0
- package/src/AdminModelTable.tsx +530 -92
- package/src/AdminNestedArrayField.tsx +59 -9
- package/src/AdminObjectPicker.tsx +19 -1
- package/src/AdminPrimitiveArrayField.tsx +30 -15
- package/src/AdminRefField.tsx +2 -0
- package/src/AdminScriptList.tsx +307 -30
- package/src/AdminScriptRunModal.tsx +410 -95
- package/src/AdminShell.tsx +296 -0
- package/src/AdminShellLayout.tsx +34 -0
- package/src/AdminVersionConfig.tsx +120 -76
- package/src/ConfigurationScreen.tsx +4 -2
- package/src/ConsentFormEditor.tsx +3 -1
- package/src/ConsentFormList.tsx +1 -1
- package/src/ConsentResponseViewer.tsx +3 -3
- package/src/DocumentStorageBrowser.tsx +1 -1
- package/src/adminModelListQueryParams.ts +61 -0
- package/src/adminShellNav.test.ts +29 -0
- package/src/adminShellNav.ts +33 -0
- package/src/index.tsx +6 -1
- package/src/isolated/AdminScriptRunModal.isolated.tsx +152 -1
- package/src/scriptRunUtils.test.ts +146 -0
- package/src/scriptRunUtils.ts +149 -0
- package/src/types.ts +69 -0
- package/src/useAdminApi.ts +11 -0
- package/src/useAdminBackgroundTask.ts +40 -0
- package/src/useAdminScripts.ts +56 -5
|
@@ -0,0 +1,474 @@
|
|
|
1
|
+
import {
|
|
2
|
+
Box,
|
|
3
|
+
Button,
|
|
4
|
+
Card,
|
|
5
|
+
Heading,
|
|
6
|
+
IconButton,
|
|
7
|
+
Page,
|
|
8
|
+
printDateAndTime,
|
|
9
|
+
Spinner,
|
|
10
|
+
Text,
|
|
11
|
+
} from "@terreno/ui";
|
|
12
|
+
import type {Href} from "expo-router";
|
|
13
|
+
import {router} from "expo-router";
|
|
14
|
+
import React, {useCallback, useMemo} from "react";
|
|
15
|
+
import {AdminVersionConfig} from "./AdminVersionConfig";
|
|
16
|
+
import type {AdminApi, AdminFieldValue, AdminModelConfig} from "./types";
|
|
17
|
+
import {resolveAdminBases} from "./types";
|
|
18
|
+
import {useAdminApi} from "./useAdminApi";
|
|
19
|
+
import {useAdminConfig} from "./useAdminConfig";
|
|
20
|
+
|
|
21
|
+
const BUILTIN_WIDGET_IDS = new Set([
|
|
22
|
+
"modelStats",
|
|
23
|
+
"modelsGrid",
|
|
24
|
+
"feature-flags-overrides",
|
|
25
|
+
"versionConfig",
|
|
26
|
+
"scriptRunner",
|
|
27
|
+
"recentActivity",
|
|
28
|
+
]);
|
|
29
|
+
|
|
30
|
+
const normalizeWidgetIds = (ids: string[] | undefined): string[] => {
|
|
31
|
+
if (!ids?.length) {
|
|
32
|
+
return [];
|
|
33
|
+
}
|
|
34
|
+
const out: string[] = [];
|
|
35
|
+
const seen = new Set<string>();
|
|
36
|
+
for (const id of ids) {
|
|
37
|
+
const normalized = id === "modelStats" ? "modelsGrid" : id;
|
|
38
|
+
if (seen.has(normalized)) {
|
|
39
|
+
continue;
|
|
40
|
+
}
|
|
41
|
+
seen.add(normalized);
|
|
42
|
+
out.push(normalized);
|
|
43
|
+
}
|
|
44
|
+
return out;
|
|
45
|
+
};
|
|
46
|
+
|
|
47
|
+
const normalizeSidebarWidgets = (ids: string[] | undefined): string[] => {
|
|
48
|
+
const normalized = normalizeWidgetIds(ids);
|
|
49
|
+
if (!normalized.length) {
|
|
50
|
+
return normalized;
|
|
51
|
+
}
|
|
52
|
+
const tail = "recentActivity";
|
|
53
|
+
const without = normalized.filter((id) => id !== tail);
|
|
54
|
+
if (normalized.includes(tail)) {
|
|
55
|
+
return [...without, tail];
|
|
56
|
+
}
|
|
57
|
+
return normalized;
|
|
58
|
+
};
|
|
59
|
+
|
|
60
|
+
const warnUnknownWidget = (widgetId: string): void => {
|
|
61
|
+
if (BUILTIN_WIDGET_IDS.has(widgetId)) {
|
|
62
|
+
return;
|
|
63
|
+
}
|
|
64
|
+
if (typeof __DEV__ !== "undefined" && __DEV__) {
|
|
65
|
+
console.warn(
|
|
66
|
+
`[AdminHome] Unknown home widget id "${widgetId}". Register a built-in or remove it from admin config.`
|
|
67
|
+
);
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
interface AdminHomeProps {
|
|
72
|
+
/** @deprecated Use `apiBase`/`routeBase`. */
|
|
73
|
+
baseUrl?: string;
|
|
74
|
+
apiBase?: string;
|
|
75
|
+
routeBase?: string;
|
|
76
|
+
api: AdminApi;
|
|
77
|
+
/**
|
|
78
|
+
* When true, omits the outer {@link Page} wrapper so the dashboard can sit under a parent
|
|
79
|
+
* screen (for example, the Expo admin index together with tools and model cards).
|
|
80
|
+
*/
|
|
81
|
+
embedded?: boolean;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const ModelGridCard: React.FC<{
|
|
85
|
+
api: AdminApi;
|
|
86
|
+
model: AdminModelConfig;
|
|
87
|
+
routeBase: string;
|
|
88
|
+
}> = ({api, model, routeBase}) => {
|
|
89
|
+
const {useListQuery} = useAdminApi(api, model.routePath, model.name);
|
|
90
|
+
const {data, isLoading} = useListQuery({limit: 1, page: 1}, {skip: !model.routePath});
|
|
91
|
+
const total = (data as {total?: number} | undefined)?.total;
|
|
92
|
+
const fieldCount = Object.keys(model.fields).length;
|
|
93
|
+
const createEnabled = model.permissions?.create !== false;
|
|
94
|
+
|
|
95
|
+
const onOpen = useCallback((): void => {
|
|
96
|
+
const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
|
|
97
|
+
const href = `${prefix}/${model.name}` as Href;
|
|
98
|
+
router.push(href);
|
|
99
|
+
}, [routeBase, model.name]);
|
|
100
|
+
|
|
101
|
+
const onCreate = useCallback((): void => {
|
|
102
|
+
if (!createEnabled) {
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
|
|
106
|
+
router.push(`${prefix}/${model.name}/create` as Href);
|
|
107
|
+
}, [createEnabled, routeBase, model.name]);
|
|
108
|
+
|
|
109
|
+
return (
|
|
110
|
+
<Box
|
|
111
|
+
accessibilityHint={`Open ${model.displayName} admin`}
|
|
112
|
+
accessibilityLabel={model.displayName}
|
|
113
|
+
border="default"
|
|
114
|
+
padding={3}
|
|
115
|
+
rounding="md"
|
|
116
|
+
width={220}
|
|
117
|
+
>
|
|
118
|
+
<Box alignItems="start" direction="row" gap={2} justifyContent="between">
|
|
119
|
+
<Box
|
|
120
|
+
accessibilityHint={`View ${model.displayName} list`}
|
|
121
|
+
accessibilityLabel={model.displayName}
|
|
122
|
+
flex="grow"
|
|
123
|
+
minWidth={0}
|
|
124
|
+
onClick={onOpen}
|
|
125
|
+
testID={`admin-home-models-grid-${model.name}`}
|
|
126
|
+
>
|
|
127
|
+
<Text bold>{model.displayName}</Text>
|
|
128
|
+
<Text color="secondaryDark" size="sm">
|
|
129
|
+
{`${fieldCount} fields`}
|
|
130
|
+
</Text>
|
|
131
|
+
<Box marginTop={1}>
|
|
132
|
+
{isLoading ? (
|
|
133
|
+
<Spinner />
|
|
134
|
+
) : (
|
|
135
|
+
<Text
|
|
136
|
+
color="secondaryDark"
|
|
137
|
+
size="sm"
|
|
138
|
+
testID={`admin-home-model-count-${model.name}`}
|
|
139
|
+
>{`${total != null ? total : "—"} rows`}</Text>
|
|
140
|
+
)}
|
|
141
|
+
</Box>
|
|
142
|
+
</Box>
|
|
143
|
+
{createEnabled ? (
|
|
144
|
+
<IconButton
|
|
145
|
+
accessibilityHint={`Create new ${model.displayName}`}
|
|
146
|
+
accessibilityLabel={`Add ${model.displayName}`}
|
|
147
|
+
iconName="plus"
|
|
148
|
+
onClick={onCreate}
|
|
149
|
+
testID={`admin-home-model-add-${model.name}`}
|
|
150
|
+
tooltipText="Add new"
|
|
151
|
+
variant="secondary"
|
|
152
|
+
/>
|
|
153
|
+
) : null}
|
|
154
|
+
</Box>
|
|
155
|
+
</Box>
|
|
156
|
+
);
|
|
157
|
+
};
|
|
158
|
+
|
|
159
|
+
const ModelsGridWidget: React.FC<{
|
|
160
|
+
api: AdminApi;
|
|
161
|
+
models: AdminModelConfig[];
|
|
162
|
+
routeBase: string;
|
|
163
|
+
}> = ({api, models, routeBase}) => {
|
|
164
|
+
return (
|
|
165
|
+
<Card padding={4} testID="admin-home-widget-modelsGrid">
|
|
166
|
+
<Heading size="sm">Models</Heading>
|
|
167
|
+
<Box direction="row" gap={3} marginTop={2} wrap>
|
|
168
|
+
{models.map((m) => (
|
|
169
|
+
<ModelGridCard api={api} key={m.name} model={m} routeBase={routeBase} />
|
|
170
|
+
))}
|
|
171
|
+
</Box>
|
|
172
|
+
</Card>
|
|
173
|
+
);
|
|
174
|
+
};
|
|
175
|
+
|
|
176
|
+
const FeatureFlagsOverridesWidget: React.FC<{
|
|
177
|
+
model?: AdminModelConfig;
|
|
178
|
+
routeBase: string;
|
|
179
|
+
}> = ({model, routeBase}) => {
|
|
180
|
+
const onOpen = useCallback((): void => {
|
|
181
|
+
if (!model) {
|
|
182
|
+
return;
|
|
183
|
+
}
|
|
184
|
+
const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
|
|
185
|
+
router.push(`${prefix}/${model.name}` as Href);
|
|
186
|
+
}, [routeBase, model]);
|
|
187
|
+
|
|
188
|
+
return (
|
|
189
|
+
<Card padding={4} testID="admin-home-widget-feature-flags-overrides">
|
|
190
|
+
<Heading size="sm">Feature flags</Heading>
|
|
191
|
+
{model ? (
|
|
192
|
+
<Box marginTop={2}>
|
|
193
|
+
<Text color="secondaryDark" size="sm">
|
|
194
|
+
Quick access to feature flag records.
|
|
195
|
+
</Text>
|
|
196
|
+
<Box marginTop={2}>
|
|
197
|
+
<Button onClick={onOpen} text={`Open ${model.displayName}`} variant="outline" />
|
|
198
|
+
</Box>
|
|
199
|
+
</Box>
|
|
200
|
+
) : (
|
|
201
|
+
<Box marginTop={2}>
|
|
202
|
+
<Text color="secondaryDark" size="sm">
|
|
203
|
+
No FeatureFlag model is registered in this admin config.
|
|
204
|
+
</Text>
|
|
205
|
+
</Box>
|
|
206
|
+
)}
|
|
207
|
+
</Card>
|
|
208
|
+
);
|
|
209
|
+
};
|
|
210
|
+
|
|
211
|
+
const RecentActivityWidget: React.FC<{
|
|
212
|
+
api: AdminApi;
|
|
213
|
+
auditModel?: AdminModelConfig;
|
|
214
|
+
}> = ({api, auditModel}) => {
|
|
215
|
+
const {useListQuery} = useAdminApi(api, auditModel?.routePath ?? "", auditModel?.name ?? "");
|
|
216
|
+
const {data, isLoading, isError} = useListQuery(
|
|
217
|
+
{limit: 8, page: 1, sort: "-createdAt"},
|
|
218
|
+
{skip: !auditModel?.routePath}
|
|
219
|
+
);
|
|
220
|
+
|
|
221
|
+
const rows = useMemo((): Record<string, AdminFieldValue>[] => {
|
|
222
|
+
const body = data as {data?: Record<string, AdminFieldValue>[]} | undefined;
|
|
223
|
+
return Array.isArray(body?.data) ? body.data : [];
|
|
224
|
+
}, [data]);
|
|
225
|
+
|
|
226
|
+
if (!auditModel) {
|
|
227
|
+
return (
|
|
228
|
+
<Card padding={4} testID="admin-home-widget-recentActivity">
|
|
229
|
+
<Heading size="sm">Recent activity</Heading>
|
|
230
|
+
<Box marginTop={2}>
|
|
231
|
+
<Text color="secondaryDark" size="sm">
|
|
232
|
+
Register an AdminAuditLog model to show recent mutations here.
|
|
233
|
+
</Text>
|
|
234
|
+
</Box>
|
|
235
|
+
</Card>
|
|
236
|
+
);
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
return (
|
|
240
|
+
<Card padding={4} testID="admin-home-widget-recentActivity">
|
|
241
|
+
<Heading size="sm">Recent activity</Heading>
|
|
242
|
+
{isLoading ? (
|
|
243
|
+
<Box alignItems="center" marginTop={3} padding={2}>
|
|
244
|
+
<Spinner />
|
|
245
|
+
</Box>
|
|
246
|
+
) : null}
|
|
247
|
+
{isError ? (
|
|
248
|
+
<Box marginTop={2}>
|
|
249
|
+
<Text color="error" size="sm">
|
|
250
|
+
Could not load audit entries.
|
|
251
|
+
</Text>
|
|
252
|
+
</Box>
|
|
253
|
+
) : null}
|
|
254
|
+
{!isLoading && !isError && rows.length === 0 ? (
|
|
255
|
+
<Box marginTop={2}>
|
|
256
|
+
<Text color="secondaryDark" size="sm">
|
|
257
|
+
No audit entries yet.
|
|
258
|
+
</Text>
|
|
259
|
+
</Box>
|
|
260
|
+
) : null}
|
|
261
|
+
{!isLoading && !isError && rows.length > 0 ? (
|
|
262
|
+
<Box gap={2} marginTop={2}>
|
|
263
|
+
{rows.map((row) => {
|
|
264
|
+
const id = String(row._id ?? row.id ?? "");
|
|
265
|
+
const verb = String(row.verb ?? "");
|
|
266
|
+
const modelName = String(row.modelName ?? "");
|
|
267
|
+
const label = String(row.recordLabel ?? row.recordId ?? "");
|
|
268
|
+
const created = row.createdAt ?? row.created;
|
|
269
|
+
const when =
|
|
270
|
+
typeof created === "string" ? printDateAndTime(created, {defaultValue: created}) : "";
|
|
271
|
+
return (
|
|
272
|
+
<Box border="default" key={id || `${verb}-${label}`} padding={2} rounding="sm">
|
|
273
|
+
<Text size="sm">
|
|
274
|
+
<Text bold>{verb}</Text> {modelName}
|
|
275
|
+
{label ? ` — ${label}` : ""}
|
|
276
|
+
</Text>
|
|
277
|
+
{when ? (
|
|
278
|
+
<Text color="secondaryDark" size="sm">
|
|
279
|
+
{when}
|
|
280
|
+
</Text>
|
|
281
|
+
) : null}
|
|
282
|
+
</Box>
|
|
283
|
+
);
|
|
284
|
+
})}
|
|
285
|
+
</Box>
|
|
286
|
+
) : null}
|
|
287
|
+
</Card>
|
|
288
|
+
);
|
|
289
|
+
};
|
|
290
|
+
|
|
291
|
+
const ScriptRunnerWidget: React.FC<{routeBase: string}> = ({routeBase}) => {
|
|
292
|
+
const onScripts = useCallback((): void => {
|
|
293
|
+
const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
|
|
294
|
+
router.push(`${prefix}/__scripts` as Href);
|
|
295
|
+
}, [routeBase]);
|
|
296
|
+
|
|
297
|
+
return (
|
|
298
|
+
<Card padding={4} testID="admin-home-widget-scriptRunner">
|
|
299
|
+
<Heading size="sm">Scripts</Heading>
|
|
300
|
+
<Box marginTop={1}>
|
|
301
|
+
<Text color="secondaryDark" size="sm">
|
|
302
|
+
Run registered admin maintenance scripts.
|
|
303
|
+
</Text>
|
|
304
|
+
</Box>
|
|
305
|
+
<Box marginTop={2}>
|
|
306
|
+
<Button onClick={onScripts} text="Open scripts" variant="primary" />
|
|
307
|
+
</Box>
|
|
308
|
+
</Card>
|
|
309
|
+
);
|
|
310
|
+
};
|
|
311
|
+
|
|
312
|
+
const renderWidget = (params: {
|
|
313
|
+
api: AdminApi;
|
|
314
|
+
apiBase: string;
|
|
315
|
+
routeBase: string;
|
|
316
|
+
widgetId: string;
|
|
317
|
+
models: AdminModelConfig[];
|
|
318
|
+
auditModel?: AdminModelConfig;
|
|
319
|
+
featureFlagModel?: AdminModelConfig;
|
|
320
|
+
}): React.ReactNode => {
|
|
321
|
+
const {api, apiBase, routeBase, widgetId, models, auditModel, featureFlagModel} = params;
|
|
322
|
+
warnUnknownWidget(widgetId);
|
|
323
|
+
switch (widgetId) {
|
|
324
|
+
case "modelStats":
|
|
325
|
+
return <ModelsGridWidget api={api} models={models} routeBase={routeBase} />;
|
|
326
|
+
case "modelsGrid":
|
|
327
|
+
return <ModelsGridWidget api={api} models={models} routeBase={routeBase} />;
|
|
328
|
+
case "feature-flags-overrides":
|
|
329
|
+
return <FeatureFlagsOverridesWidget model={featureFlagModel} routeBase={routeBase} />;
|
|
330
|
+
case "versionConfig":
|
|
331
|
+
return <AdminVersionConfig api={api} apiBase={apiBase} embedded routeBase={routeBase} />;
|
|
332
|
+
case "scriptRunner":
|
|
333
|
+
return <ScriptRunnerWidget routeBase={routeBase} />;
|
|
334
|
+
case "recentActivity":
|
|
335
|
+
return <RecentActivityWidget api={api} auditModel={auditModel} />;
|
|
336
|
+
default:
|
|
337
|
+
return null;
|
|
338
|
+
}
|
|
339
|
+
};
|
|
340
|
+
|
|
341
|
+
/**
|
|
342
|
+
* Config-driven admin home dashboard: renders `home.slots` from `/admin/config` with built-in
|
|
343
|
+
* widgets (model grid with counts, scripts, version config, audit recent activity).
|
|
344
|
+
* `navGlobal` and `contentTop` widget ids render together in one top row (same flex line, wrapping
|
|
345
|
+
* as needed) so strips like scripts + feature flags stay side by side.
|
|
346
|
+
*/
|
|
347
|
+
export const AdminHome: React.FC<AdminHomeProps> = ({
|
|
348
|
+
baseUrl,
|
|
349
|
+
apiBase,
|
|
350
|
+
routeBase,
|
|
351
|
+
api,
|
|
352
|
+
embedded = false,
|
|
353
|
+
}) => {
|
|
354
|
+
const {apiBase: resolvedApiBase, routeBase: resolvedRouteBase} = resolveAdminBases({
|
|
355
|
+
apiBase,
|
|
356
|
+
baseUrl,
|
|
357
|
+
routeBase,
|
|
358
|
+
});
|
|
359
|
+
const {config, error, isLoading} = useAdminConfig(api, resolvedApiBase);
|
|
360
|
+
|
|
361
|
+
const models = (config?.models ?? []) as AdminModelConfig[];
|
|
362
|
+
const auditModel = useMemo(
|
|
363
|
+
() => models.find((m) => m.name === "AdminAuditLog" || m.routePath.includes("audit-log")),
|
|
364
|
+
[models]
|
|
365
|
+
);
|
|
366
|
+
const featureFlagModel = useMemo(
|
|
367
|
+
() => models.find((m) => m.name === "FeatureFlag" || m.displayName === "Feature Flags"),
|
|
368
|
+
[models]
|
|
369
|
+
);
|
|
370
|
+
|
|
371
|
+
const slots = config?.home?.slots;
|
|
372
|
+
const navGlobal = normalizeWidgetIds(slots?.navGlobal);
|
|
373
|
+
const contentTop = normalizeWidgetIds(slots?.contentTop);
|
|
374
|
+
/** Shown in one horizontal band so scripts, feature flags, etc. align on the same row. */
|
|
375
|
+
const topBandWidgetIds = useMemo(() => [...navGlobal, ...contentTop], [navGlobal, contentTop]);
|
|
376
|
+
const main = normalizeWidgetIds(slots?.main);
|
|
377
|
+
const sidebar = normalizeSidebarWidgets(slots?.sidebar);
|
|
378
|
+
|
|
379
|
+
if (isLoading) {
|
|
380
|
+
const loadingBody = (
|
|
381
|
+
<Box alignItems="center" justifyContent="center" padding={6} testID="admin-home-loading">
|
|
382
|
+
<Spinner />
|
|
383
|
+
</Box>
|
|
384
|
+
);
|
|
385
|
+
if (embedded) {
|
|
386
|
+
return loadingBody;
|
|
387
|
+
}
|
|
388
|
+
return (
|
|
389
|
+
<Page color="transparent" maxWidth="100%" padding={0} title={config?.home?.title ?? "Admin"}>
|
|
390
|
+
{loadingBody}
|
|
391
|
+
</Page>
|
|
392
|
+
);
|
|
393
|
+
}
|
|
394
|
+
|
|
395
|
+
if (error || !config) {
|
|
396
|
+
const errorBody = (
|
|
397
|
+
<Box padding={4} testID="admin-home-error">
|
|
398
|
+
<Text color="error">Failed to load admin configuration.</Text>
|
|
399
|
+
</Box>
|
|
400
|
+
);
|
|
401
|
+
if (embedded) {
|
|
402
|
+
return errorBody;
|
|
403
|
+
}
|
|
404
|
+
return (
|
|
405
|
+
<Page color="transparent" maxWidth="100%" padding={0} title="Admin">
|
|
406
|
+
{errorBody}
|
|
407
|
+
</Page>
|
|
408
|
+
);
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
const title = config.home?.title ?? "Admin";
|
|
412
|
+
|
|
413
|
+
const widgetParams = {
|
|
414
|
+
api,
|
|
415
|
+
apiBase: resolvedApiBase,
|
|
416
|
+
auditModel,
|
|
417
|
+
featureFlagModel,
|
|
418
|
+
models,
|
|
419
|
+
routeBase: resolvedRouteBase,
|
|
420
|
+
};
|
|
421
|
+
|
|
422
|
+
const dashboardBody = (
|
|
423
|
+
<Box gap={4} padding={0} width="100%">
|
|
424
|
+
{!embedded ? <Heading size="md">{title}</Heading> : null}
|
|
425
|
+
|
|
426
|
+
{topBandWidgetIds.length > 0 ? (
|
|
427
|
+
<Box direction="row" gap={3} testID="admin-home-slot-top" wrap>
|
|
428
|
+
{topBandWidgetIds.map((id) => (
|
|
429
|
+
<Box key={`top-${id}`}>{renderWidget({...widgetParams, widgetId: id})}</Box>
|
|
430
|
+
))}
|
|
431
|
+
</Box>
|
|
432
|
+
) : null}
|
|
433
|
+
|
|
434
|
+
<Box alignItems="start" direction={embedded ? "column" : "row"} gap={4}>
|
|
435
|
+
{main.length > 0 ? (
|
|
436
|
+
<Box
|
|
437
|
+
flex="grow"
|
|
438
|
+
gap={3}
|
|
439
|
+
minWidth={embedded ? 0 : 280}
|
|
440
|
+
testID="admin-home-slot-main"
|
|
441
|
+
{...(embedded ? {width: "100%"} : {})}
|
|
442
|
+
>
|
|
443
|
+
{main.map((id) => (
|
|
444
|
+
<Box key={`mn-${id}`}>{renderWidget({...widgetParams, widgetId: id})}</Box>
|
|
445
|
+
))}
|
|
446
|
+
</Box>
|
|
447
|
+
) : null}
|
|
448
|
+
{sidebar.length > 0 ? (
|
|
449
|
+
<Box
|
|
450
|
+
direction="column"
|
|
451
|
+
gap={3}
|
|
452
|
+
minWidth={embedded ? 0 : 280}
|
|
453
|
+
testID="admin-home-slot-sidebar"
|
|
454
|
+
width={embedded ? "100%" : 320}
|
|
455
|
+
>
|
|
456
|
+
{sidebar.map((id) => (
|
|
457
|
+
<Box key={`sb-${id}`}>{renderWidget({...widgetParams, widgetId: id})}</Box>
|
|
458
|
+
))}
|
|
459
|
+
</Box>
|
|
460
|
+
) : null}
|
|
461
|
+
</Box>
|
|
462
|
+
</Box>
|
|
463
|
+
);
|
|
464
|
+
|
|
465
|
+
if (embedded) {
|
|
466
|
+
return dashboardBody;
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
return (
|
|
470
|
+
<Page color="transparent" maxWidth="100%" padding={0} scroll title={title}>
|
|
471
|
+
{dashboardBody}
|
|
472
|
+
</Page>
|
|
473
|
+
);
|
|
474
|
+
};
|
|
@@ -124,7 +124,11 @@ describe("AdminModelForm", () => {
|
|
|
124
124
|
/>
|
|
125
125
|
);
|
|
126
126
|
expect(toJSON()).toBeDefined();
|
|
127
|
-
expect(setOptions).
|
|
127
|
+
expect(setOptions).toHaveBeenCalledWith(
|
|
128
|
+
expect.objectContaining({
|
|
129
|
+
title: "New User",
|
|
130
|
+
})
|
|
131
|
+
);
|
|
128
132
|
});
|
|
129
133
|
|
|
130
134
|
it("renders spinner during edit when the item is loading", () => {
|
|
@@ -140,6 +144,7 @@ describe("AdminModelForm", () => {
|
|
|
140
144
|
/>
|
|
141
145
|
);
|
|
142
146
|
expect(toJSON()).toBeDefined();
|
|
147
|
+
expect(setOptions).toHaveBeenCalledWith(expect.objectContaining({title: "User"}));
|
|
143
148
|
});
|
|
144
149
|
|
|
145
150
|
it("initializes form state from fetched item data in edit mode", () => {
|
|
@@ -160,6 +165,39 @@ describe("AdminModelForm", () => {
|
|
|
160
165
|
/>
|
|
161
166
|
);
|
|
162
167
|
expect(toJSON()).toBeDefined();
|
|
168
|
+
expect(setOptions).toHaveBeenCalledWith(expect.objectContaining({title: "Existing"}));
|
|
169
|
+
});
|
|
170
|
+
|
|
171
|
+
it("uses recordTitleField from model config for the navigation title", () => {
|
|
172
|
+
configState.config = {
|
|
173
|
+
...config,
|
|
174
|
+
models: [
|
|
175
|
+
{
|
|
176
|
+
...modelConfig,
|
|
177
|
+
fieldOrder: ["email", "name"],
|
|
178
|
+
fields: {
|
|
179
|
+
email: {required: false, type: "string"},
|
|
180
|
+
name: {required: false, type: "string"},
|
|
181
|
+
},
|
|
182
|
+
recordTitleField: "email",
|
|
183
|
+
},
|
|
184
|
+
],
|
|
185
|
+
};
|
|
186
|
+
readState.data = {
|
|
187
|
+
email: "pick@me.com",
|
|
188
|
+
name: "Other",
|
|
189
|
+
};
|
|
190
|
+
const {toJSON} = renderWithTheme(
|
|
191
|
+
<AdminModelForm
|
|
192
|
+
api={{} as unknown as AdminApi}
|
|
193
|
+
baseUrl="/admin"
|
|
194
|
+
itemId="u1"
|
|
195
|
+
mode="edit"
|
|
196
|
+
modelName="User"
|
|
197
|
+
/>
|
|
198
|
+
);
|
|
199
|
+
expect(toJSON()).toBeDefined();
|
|
200
|
+
expect(setOptions).toHaveBeenCalledWith(expect.objectContaining({title: "pick@me.com"}));
|
|
163
201
|
});
|
|
164
202
|
|
|
165
203
|
it("renders 'No editable fields' when the model has only system fields", () => {
|
|
@@ -618,6 +656,48 @@ describe("AdminModelForm", () => {
|
|
|
618
656
|
expect(routerBack).not.toHaveBeenCalled();
|
|
619
657
|
});
|
|
620
658
|
|
|
659
|
+
it("excludes readonly fields from the PATCH body on save", async () => {
|
|
660
|
+
configState.config = {
|
|
661
|
+
...config,
|
|
662
|
+
models: [
|
|
663
|
+
{
|
|
664
|
+
...modelConfig,
|
|
665
|
+
fieldOrder: ["email", "name"],
|
|
666
|
+
fields: {
|
|
667
|
+
email: {required: false, type: "string"},
|
|
668
|
+
name: {required: false, type: "string"},
|
|
669
|
+
},
|
|
670
|
+
readonlyFields: ["email"],
|
|
671
|
+
},
|
|
672
|
+
],
|
|
673
|
+
};
|
|
674
|
+
readState.data = {email: "locked@x.com", name: "N"};
|
|
675
|
+
let savedHeaderRight: React.ReactElement | null = null;
|
|
676
|
+
setOptions.mockImplementation((opts: Record<string, unknown>) => {
|
|
677
|
+
if (opts?.headerRight) {
|
|
678
|
+
savedHeaderRight = opts.headerRight();
|
|
679
|
+
}
|
|
680
|
+
});
|
|
681
|
+
renderWithTheme(
|
|
682
|
+
<AdminModelForm
|
|
683
|
+
api={{} as unknown as AdminApi}
|
|
684
|
+
baseUrl="/admin"
|
|
685
|
+
itemId="u1"
|
|
686
|
+
mode="edit"
|
|
687
|
+
modelName="User"
|
|
688
|
+
/>
|
|
689
|
+
);
|
|
690
|
+
const header = renderWithTheme(savedHeaderRight as unknown as React.ReactElement);
|
|
691
|
+
await act(async () => {
|
|
692
|
+
fireEvent.press(header.getByTestId("admin-save-button"));
|
|
693
|
+
await new Promise((r) => setTimeout(r, 600));
|
|
694
|
+
});
|
|
695
|
+
expect(updateFn).toHaveBeenCalled();
|
|
696
|
+
const arg = updateFn.mock.calls[0][0] as {body: Record<string, unknown>; id: string};
|
|
697
|
+
expect(arg.body.email).toBeUndefined();
|
|
698
|
+
expect(arg.body.name).toBeDefined();
|
|
699
|
+
});
|
|
700
|
+
|
|
621
701
|
it("updates an existing item in edit mode", async () => {
|
|
622
702
|
configState.config = config;
|
|
623
703
|
readState.data = {active: true, age: 1, email: "e@x.com", name: "Name"};
|